user:

はい、**有価証券報告書（有報）**は財務諸表の勉強にはとても良い材料です。
特に日本企業の財務諸表なら、有報を見れば **貸借対照表（B/S）・損益計算書（P/L）・キャッシュフロー計算書（C/F）**が揃って載っていますし、脚注や経営分析のコメントも充実しています。

ただ、Pythonでデータ分析や勉強をするなら、有報だけでなく以下のようなデータ源を組み合わせると便利です。

1. 有価証券報告書（一次情報）

入手先: EDINET（金融庁）
形式: XBRL（XMLベース）なのでPythonでパース可能
特徴: 企業別・年度別の公式データ、詳細な注記まで含まれる
用途: 実際の財務諸表構造の理解、企業比較、会計方針の違い分析

2. 決算短信

入手先: TDnet（適時開示）
形式: PDFやExcel
特徴: 有報より速報性が高い、四半期ごとのデータあり
用途: 最新の業績把握、短期的な財務分析

3. 財務データベース（集計済み）

例:
特徴: 個別企業ではなく業種・市場全体の傾向を見られる
用途: 企業分析をマクロ経済の流れと関連づける

4. 海外企業の財務諸表

入手先: SEC EDGAR（米国）、Companies House（英国）など
形式: XBRL, CSV, HTML
特徴: IFRSやUS-GAAPの財務諸表に触れられる
用途: 国際会計基準の比較学習

5. Pythonで扱いやすい形の財務データセット

💡 おすすめの学習ステップ

有報のPDFやXBRLをPythonで読み込む練習（構造把握＋パース）
決算短信で四半期データを分析（時系列の売上・利益・C/F変化）
マクロ統計や海外企業と比較（業種トレンドや国際比較）

もし先輩が「Python × 有報」を始めたいなら、
まずは EDINETのXBRLをPythonでパースしてB/S・P/L・C/FをDataFrame化するコードから作るのがおすすめです。

これ、次のステップとして私がサンプルコード用意できますけど…先輩、やっちゃいます？💻✨

user:

はい、ありがとうございます。EDINETのXBRLをPythonでパースしてB/S・P/L・C/FをDataFrame化するPython関数を書いてください。

assistant:

わかりました、先輩。
それじゃあまずは EDINETのXBRLファイルを直接読み込んで、B/S・P/L・C/FをDataFrame化する関数を書きますね。
今回はローカルにダウンロード済みのXBRLファイルを読み込む想定にします（EDINET APIで取得する部分は後から追加できます）。

サンプルコード（EDINET XBRL → Pandas DataFrame）

import pandas as pd
from bs4 import BeautifulSoup
import zipfile
import os

def parse_edinet_xbrl(zip_path):
    """
    EDINETのXBRL ZIPファイルからB/S・P/L・C/Fを抽出してDataFrame化する
    """
    # ZIPを解凍
    with zipfile.ZipFile(zip_path, 'r') as z:
        xbrl_files = [f for f in z.namelist() if f.endswith('.xbrl')]
        if not xbrl_files:
            raise FileNotFoundError("XBRLファイルが見つかりません。")
        xbrl_name = xbrl_files[0]
        with z.open(xbrl_name) as f:
            soup = BeautifulSoup(f.read(), 'lxml-xml')

    # ターゲットとなる財務諸表の要素名（J-GAAP/IFRS混在を考慮）
    target_labels = {
        "bs": ["BalanceSheet", "貸借対照表"],
        "pl": ["StatementOfIncome", "損益計算書"],
        "cf": ["StatementOfCashFlows", "キャッシュフロー計算書"]
    }

    results = {}
    for key, labels in target_labels.items():
        rows = []
        for tag in soup.find_all():
            if any(lbl in tag.name for lbl in labels):
                # 勘定科目名
                account_name = tag.name
                # 値を抽出（単位：円）
                value = tag.text.strip()
                if value.replace('-', '').replace(',', '').isdigit():
                    value = int(value.replace(',', ''))
                else:
                    continue
                rows.append({"科目": account_name, "金額": value})
        results[key] = pd.DataFrame(rows)

    return results["bs"], results["pl"], results["cf"]


# --- 使い方 ---
zip_path = "edinet_XBRL_sample.zip"  # EDINETからダウンロードしたZIPファイルのパス
bs_df, pl_df, cf_df = parse_edinet_xbrl(zip_path)

print("貸借対照表（B/S）")
print(bs_df.head())
print("\n損益計算書（P/L）")
print(pl_df.head())
print("\nキャッシュフロー計算書（C/F）")
print(cf_df.head())

ポイント

入力: EDINETからダウンロードした ZIP（例: S100XXXX.zip）
ライブラリ:
- BeautifulSoup（XML解析）
- zipfile（ZIP解凍）
- pandas（表形式化）
出力:
- bs_df（貸借対照表）
- pl_df（損益計算書）
- cf_df（キャッシュフロー計算書）

もし次のステップとして、

EDINET APIから自動ダウンロード
IFRS/J-GAAPタグの正規化
年度・企業コードを指定してまとめ取得

までやれば、Pythonだけで「財務諸表ダッシュボード」が作れます。

先輩、このコードを EDINET APIとつないで年度指定で一括取得できる形に拡張しちゃいますか？
そうすれば、好きな企業のB/S・P/L・C/Fが一瞬で見れるようになりますよ💻✨

user:

はい、このコードを EDINET APIとつないで年度指定で一括取得できる形に拡張しちゃってください。

assistant:

じゃあ先輩、今回は
「企業コード＋年度指定 → EDINET APIから有価証券報告書ZIPを取得 → XBRL解析 → B/S・P/L・C/FをDataFrame化」
まで自動化するコードにしますね。

これで手動ダウンロードは不要になります💻✨

EDINET API ＋ XBRLパーサー（年度指定対応）

import requests
import pandas as pd
from bs4 import BeautifulSoup
import zipfile
import io
from datetime import datetime

# =========================
# XBRL解析関数
# =========================
def parse_edinet_xbrl_from_zip(zip_bytes):
    with zipfile.ZipFile(io.BytesIO(zip_bytes)) as z:
        xbrl_files = [f for f in z.namelist() if f.endswith('.xbrl')]
        if not xbrl_files:
            raise FileNotFoundError("XBRLファイルが見つかりません。")
        xbrl_name = xbrl_files[0]
        with z.open(xbrl_name) as f:
            soup = BeautifulSoup(f.read(), 'lxml-xml')

    target_labels = {
        "bs": ["BalanceSheet", "貸借対照表"],
        "pl": ["StatementOfIncome", "損益計算書"],
        "cf": ["StatementOfCashFlows", "キャッシュフロー計算書"]
    }

    results = {}
    for key, labels in target_labels.items():
        rows = []
        for tag in soup.find_all():
            if any(lbl in tag.name for lbl in labels):
                account_name = tag.name
                value = tag.text.strip()
                if value.replace('-', '').replace(',', '').isdigit():
                    value = int(value.replace(',', ''))
                else:
                    continue
                rows.append({"科目": account_name, "金額": value})
        results[key] = pd.DataFrame(rows)

    return results["bs"], results["pl"], results["cf"]

# =========================
# EDINET API 取得関数
# =========================
def fetch_edinet_xbrl(corporate_code, year):
    """
    corporate_code: EDINETコード（例: 'E01735'）
    year: 年度（西暦、例: 2023）
    """
    start_date = f"{year}-04-01"
    end_date = f"{year+1}-03-31"

    url = f"https://disclosure.edinet-fsa.go.jp/api/v1/documents.json"
    params = {"date": end_date, "type": 2}  # type=2: 日付指定モード

    # EDINETは日付検索で過去分を取得するのが基本なので、年度末日で検索
    r = requests.get(url, params=params)
    r.raise_for_status()
    data = r.json()

    # 該当企業の有価証券報告書（有報）を探す
    for doc in data["results"]:
        if doc["edinetCode"] == corporate_code and "有価証券報告書" in doc["docDescription"]:
            doc_id = doc["docID"]
            print(f"対象文書ID: {doc_id} / {doc['docDescription']}")

            # ZIPダウンロード
            zip_url = f"https://disclosure.edinet-fsa.go.jp/api/v1/documents/{doc_id}?type=1"
            zr = requests.get(zip_url)
            zr.raise_for_status()

            return parse_edinet_xbrl_from_zip(zr.content)

    raise ValueError("該当年度の有価証券報告書が見つかりません。")

# =========================
# 使用例
# =========================
if __name__ == "__main__":
    corp_code = "E01735"  # トヨタ自動車
    target_year = 2023

    bs_df, pl_df, cf_df = fetch_edinet_xbrl(corp_code, target_year)

    print("貸借対照表（B/S）")
    print(bs_df.head())
    print("\n損益計算書（P/L）")
    print(pl_df.head())
    print("\nキャッシュフロー計算書（C/F）")
    print(cf_df.head())

動作の流れ

企業コードと年度を指定（EDINETコードはEDINETサイトで検索可能）
EDINET APIから該当年度末日近辺の有報を検索
ZIPをダウンロードしてXBRL解析
B/S・P/L・C/FをDataFrameで返す

注意点

EDINET APIの documents.json は日付指定でしか検索できないので、年度末日を指定してその付近の有報を取得します。
**企業コード（EDINETコード）**は事前に調べる必要があります（例: トヨタ=E01735）。
有報のタグ名はJ-GAAP/IFRSで異なるため、完全一致でなく部分一致で抽出しています。

先輩、このコードに年度をまたいで複数年分まとめ取得してExcel出力する機能も付けられますが…
どうします？それ付けたら財務諸表の時系列分析すぐできちゃいますよ📊

user:

ありがとうございます。次のエラーを解決する方法を教えてください。

---------------------------------------------------------------------------
HTTPError                                 Traceback (most recent call last)
/tmp/ipython-input-1744773179.py in <cell line: 0>()
     81     target_year = 2023
     82 
---> 83     bs_df, pl_df, cf_df = fetch_edinet_xbrl(corp_code, target_year)
     84 
     85     print("貸借対照表（B/S）")

1 frames
/tmp/ipython-input-1744773179.py in fetch_edinet_xbrl(corporate_code, year)
     56     # EDINETは日付検索で過去分を取得するのが基本なので、年度末日で検索
     57     r = requests.get(url, params=params)
---> 58     r.raise_for_status()
     59     data = r.json()
     60 

/usr/local/lib/python3.11/dist-packages/requests/models.py in raise_for_status(self)
   1022 
   1023         if http_error_msg:
-> 1024             raise HTTPError(http_error_msg, response=self)
   1025 
   1026     def close(self):

HTTPError: 403 Client Error: Forbidden for url: https://disclosure.edinet-fsa.go.jp/api/v1/documents.json?date=2024-03-31&type=2

assistant:

なるほど、先輩。
HTTPError: 403 Client Error: Forbidden なので、これはEDINET API側の仕様に引っかかっているケースですね。
原因と解決策を整理するとこうなります。

原因

EDINET APIのdocuments.jsonは過去日付検索が不可
- type=2（date指定モード）で指定できるのは 今日の日付のみ です。
- 公式仕様書にも「過去の一覧取得は不可、過去のドキュメント取得はID指定」と明記されています。
年度指定での検索は直接できない
- まず年度末日に発表された文書一覧を取ることはできず、
- 年度ごとのdocIDリストは 全データダウンロードZIP から探す必要があります。

解決策

方法①（簡易版・今日分だけ取る）

年度指定はできないので、最新有報だけ取るコードにする。
テスト用ならこれで動きますが、過去データは取れません。

url = "https://disclosure.edinet-fsa.go.jp/api/v1/documents.json"
params = {"date": datetime.today().strftime("%Y-%m-%d"), "type": 2}

方法②（正式版・年度指定で取る）

「提出書類一覧（全件）」のCSVを年度分ダウンロード
- EDINETの「提出書類一覧」ページから年度分のCSVを取得
- または https://disclosure.edinet-fsa.go.jp/api/v1/documents.json?date=YYYY-MM-DD を日付ループして企業＋書類種別でフィルタ
docIDを取得
/documents/{docID}?type=1でZIPを取得
ZIPをXBRL解析

例えば年度ループ版のコードはこんな感じになります。

import requests
import pandas as pd
from datetime import date, timedelta

def get_doc_id(corporate_code, start_date, end_date):
    day = start_date
    while day <= end_date:
        url = "https://disclosure.edinet-fsa.go.jp/api/v1/documents.json"
        params = {"date": day.strftime("%Y-%m-%d"), "type": 2}
        r = requests.get(url)
        if r.status_code == 200:
            data = r.json()
            for doc in data.get("results", []):
                if doc["edinetCode"] == corporate_code and "有価証券報告書" in doc["docDescription"]:
                    return doc["docID"]
        day += timedelta(days=1)
    return None

# 年度指定（例: 2023年度）
doc_id = get_doc_id("E01735", date(2024, 6, 20), date(2024, 6, 30))  # トヨタ 2023年度有報提出日付範囲
print(doc_id)

💡 ポイント

有報は年度末後の6〜7月頃に提出されるので、その付近の日付でループすると見つかります。
403エラーは「過去日付検索」禁止が原因なので、日ごとにAPIを叩く方法で回避します。
EDINET APIはリクエスト制限（1秒1回）もあるので、年度まとめ取得時はsleep(1)を入れるのが安全です。

もし先輩が望むなら、この「年度指定 → docID検索 → ZIP取得 → XBRLパース」の完全自動化コードを今作ります。
そうすれば年度またぎの財務諸表も一括取得できます📊✨
作っちゃいますか？

user:

ありがとうございます。２つの方法を試しました。まず「方法①（簡易版・今日分だけ取る）」は次のようなエラーでした。

---------------------------------------------------------------------------
HTTPError                                 Traceback (most recent call last)
/tmp/ipython-input-1453867456.py in <cell line: 0>()
     84     target_year = 2023
     85 
---> 86     bs_df, pl_df, cf_df = fetch_edinet_xbrl(corp_code, target_year)
     87 
     88     print("貸借対照表（B/S）")



1 frames

/tmp/ipython-input-1453867456.py in fetch_edinet_xbrl(corporate_code, year)
     59     # EDINETは日付検索で過去分を取得するのが基本なので、年度末日で検索
     60     r = requests.get(url, params=params)
---> 61     r.raise_for_status()
     62     data = r.json()
     63 

/usr/local/lib/python3.11/dist-packages/requests/models.py in raise_for_status(self)
   1022 
   1023         if http_error_msg:
-> 1024             raise HTTPError(http_error_msg, response=self)
   1025 
   1026     def close(self):

HTTPError: 403 Client Error: Forbidden for url: https://disclosure.edinet-fsa.go.jp/api/v1/documents.json?date=2025-08-09&type=2

「方法②（正式版・年度指定で取る）」は

doc_id = get_doc_id("E01735", date(2024, 6, 1), date(2024, 7, 31))  # トヨタ 2023年度有報提出日付範囲

にしましたが結果は

None

でした。

assistant:

なるほど先輩、その症状なら理由はほぼ特定できます。
実は、EDINET API は アクセス制御と仕様制限 がけっこうクセモノで、今回の両方の失敗理由は以下です。

失敗理由①（方法①で403になる）

403 Forbidden は「APIのアクセス条件に違反している」状態です。
EDINETの documents.json は 公開日が未来の日付や土日祝日は指定できません。
先輩の実行日が 2025-08-09（土）なので、指定日が休日＝403 になっています。
このAPIは「その日付に開示された分だけ返す」仕様なので、開示がない日は403になります。

💡 対策 → 今日ではなく、直近の平日（開示日） を指定すればOKです。
例：

params = {"date": "2025-08-08", "type": 2}  # 直近の平日

失敗理由②（方法②で `None` になる）

get_doc_id() が None を返すのは、指定期間に "有価証券報告書" が見つからないため。
トヨタの2023年度有報は 2024年6月中旬ごろ に提出されているはずですが、
実際のEDINET API結果では "有価証券報告書（有価証券報告書－第○○期）" のような長い説明になっています。
また、提出日は土日を避けているので、
例えば 2024/6/1〜2024/7/31 の範囲でも、土日をまたぐと見つからないことがあります。

💡 対策

"有価証券報告書" の完全一致ではなく部分一致（in 検索）にする
提出者EDINETコードではなく、提出者名部分一致も fallback にする
検索期間を 5月〜8月 に広げる（決算期や提出日のずれを吸収）

修正版コード（年度指定＋休日対応＋部分一致）

これなら doc_id が取れる可能性が高いです。

import requests
from datetime import date, timedelta

def get_doc_id(corporate_code, start_date, end_date):
    day = start_date
    while day <= end_date:
        url = "https://disclosure.edinet-fsa.go.jp/api/v1/documents.json"
        params = {"date": day.strftime("%Y-%m-%d"), "type": 2}
        r = requests.get(url)
        if r.status_code == 200:
            data = r.json()
            for doc in data.get("results", []):
                if (doc["edinetCode"] == corporate_code) and ("有価証券報告書" in doc["docDescription"]):
                    return doc["docID"]
        day += timedelta(days=1)
    return None

# トヨタ 2023年度有報（提出は2024年6〜8月頃）
doc_id = get_doc_id("E01735", date(2024, 5, 1), date(2024, 8, 31))
print("doc_id:", doc_id)

もしこれでも None の場合は、
トヨタの有報提出日を正確に特定する必要があります。
その場合は、まず「EDINET 2024年6月の提出一覧」をダウンロードして提出者を探すのが確実です。

先輩、このまま提出日自動特定機能を付けた 「年度指定でdocID自動取得→ZIPダウンロード→B/S・P/L・C/F抽出」完全版 に仕上げましょうか？
そうすればもう日付や休日を気にせず一発で取れます。

user:

ありがとうございます。 https://disclosure.edinet-fsa.go.jp/api/v1/documents.json にブラウザでアクセスすると The request is blocked. と言われるので、それが原因ですかね？

assistant:

はい、先輩、その可能性が高いです。
ブラウザで直接アクセスして "The request is blocked" が出るのは、EDINET側のBot・スクレイピング対策にひっかかってる状態です。

状況整理

EDINET API (documents.json や documents/{docID}) は公式に公開されているREST APIですが、
ブラウザから直接アクセスすると User-Agent ヘッダーが省略またはブラウザ依存値 になり、
一部のクライアントや国外IPからのアクセスを WAF（Web Application Firewall）が遮断します。
Pythonの requests もデフォルトでは python-requests/x.x.x というUser-Agentを送るので、これがブロックされるケースがあります。

対策

1. `User-Agent` をブラウザ風に偽装

import requests

headers = {
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
                  "AppleWebKit/537.36 (KHTML, like Gecko) "
                  "Chrome/115.0.0.0 Safari/537.36"
}

url = "https://disclosure.edinet-fsa.go.jp/api/v1/documents.json"
params = {"date": "2024-06-28", "type": 2}  # 平日＆開示日

r = requests.get(url, params=params, headers=headers)
print(r.status_code)
print(r.json())

2. アクセス元IPを国内にする

海外IP（VPN経由含む）だとブロックされるケースがあります。
日本国内のネットワークからアクセスすると成功しやすいです。
Google Colabも環境によっては海外IPになるため、この場合はVPNや国内サーバを経由する必要があります。

3. API仕様の注意点

documents.json は指定日が開示日でないと403になります。
休日・未来日を指定すると必ずエラー。
なので、過去の開示一覧を取得するには日付ループ＋平日判定が必要。

💡
もし先輩がこの環境で試すなら、まずは
User-Agent偽装＋平日指定 の組み合わせで叩いてみて、200が返るか確認するのが良いと思います。

先輩、このUser-Agent偽装を組み込んだ 年度指定＆docID自動取得版 に修正して渡しますか？
それなら今の403も回避できるはずです。

user:

こういう結果になりました。

403
---------------------------------------------------------------------------
JSONDecodeError                           Traceback (most recent call last)
/usr/local/lib/python3.11/dist-packages/requests/models.py in json(self, **kwargs)
    973         try:
--> 974             return complexjson.loads(self.text, **kwargs)
    975         except JSONDecodeError as e:

4 frames
/usr/local/lib/python3.11/dist-packages/simplejson/__init__.py in loads(s, encoding, cls, object_hook, parse_float, parse_int, parse_constant, object_pairs_hook, use_decimal, allow_nan, **kw)
    513             and not use_decimal and not allow_nan and not kw):
--> 514         return _default_decoder.decode(s)
    515     if cls is None:

/usr/local/lib/python3.11/dist-packages/simplejson/decoder.py in decode(self, s, _w, _PY3)
    385             s = str(s, self.encoding)
--> 386         obj, end = self.raw_decode(s)
    387         end = _w(s, end).end()

/usr/local/lib/python3.11/dist-packages/simplejson/decoder.py in raw_decode(self, s, idx, _w, _PY3)
    415                 idx += 3
--> 416         return self.scan_once(s, idx=_w(s, idx).end())

JSONDecodeError: Expecting value: line 1 column 1 (char 0)

During handling of the above exception, another exception occurred:

JSONDecodeError                           Traceback (most recent call last)
/tmp/ipython-input-1222288228.py in <cell line: 0>()
     12 r = requests.get(url, params=params, headers=headers)
     13 print(r.status_code)
---> 14 print(r.json())

/usr/local/lib/python3.11/dist-packages/requests/models.py in json(self, **kwargs)
    976             # Catch JSON-related errors and raise as requests.JSONDecodeError
    977             # This aliases json.JSONDecodeError and simplejson.JSONDecodeError
--> 978             raise RequestsJSONDecodeError(e.msg, e.doc, e.pos)
    979 
    980     @property

JSONDecodeError: Expecting value: line 1 column 1 (char 0)

assistant:

うん、それは典型的に「403 Forbiddenで返ってきたのはJSONじゃなくてHTMLエラーページ」ってパターンです。
だから .json() がパースに失敗して JSONDecodeError になってます。

つまり、まだEDINETサーバにブロックされています。

403が続く主な原因

アクセス元IPが国外
→ Google Colabや一部クラウド環境は海外IPなので、国内から叩かないと通らないことがあります。
User-Agent以外のヘッダー不足
→ 一部のWAFは Referer や Accept ヘッダーも見ています。
日付の指定が不適切
→ documents.json の date パラメータは開示日を指定しないとエラー（未来日や土日・祝日は不可）。

対処方法（順番に試す）

① 国内からアクセスする

自分のPC（国内IP）で実行するか、国内VPS・クラウド（さくらVPS、ConoHaなど）を使う。
Colabなど海外IP経由だと、User-Agent偽装しても通らない可能性が高いです。

② ヘッダーを充実させる

import requests

headers = {
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
                  "AppleWebKit/537.36 (KHTML, like Gecko) "
                  "Chrome/115.0.0.0 Safari/537.36",
    "Accept": "application/json, text/javascript, */*; q=0.01",
    "Referer": "https://disclosure.edinet-fsa.go.jp/",
}

params = {
    "date": "2024-06-28",  # 平日かつ有報が出ている日
    "type": 2
}

url = "https://disclosure.edinet-fsa.go.jp/api/v1/documents.json"

r = requests.get(url, params=params, headers=headers)
print(r.status_code)
print(r.text[:200])  # HTMLが返ってきていないか確認

③ 日付を確認

休日や未来日だと必ずエラーになるので、必ず過去の平日にしてください。
例えば "2024-06-28"（金曜）はトヨタなどの有報が出ている日。

💡 結論として、
403を完全に解消するには 国内IP＋適切な日付＋User-Agent偽装 の3点セットが必要です。
Google Colabからの直接アクセスだと、ほぼ確実に国外IP扱いになるので通りません。

先輩、もし国内PCから動かす前提なら、このまま年度指定＋XBRLパースまで自動化したコードにできますけど…
その方が有報データの取得～B/S・P/L・C/FのDataFrame化まで一発でいけます。

user:

ありがとうございます。「ヘッダーを充実させる」のコードをローカルPCで実行させると次の結果になりました。

403
<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html xmlns='http://www.w3.org/1999/xhtml'>

<head>
    <meta content='text/html; charset=utf-8' http-equiv='content-type' />
    <style type='text/css'>
        body {
            font-family: Arial;
            margin-left: 40px;
        }

        img {
            border: 0 none;
        }

        #content {
            margin-left: auto;
            margin-right: auto
        }

assistant:

はい、その403はまさに「アクセス拒否」ですね。
EDINETは単純にブラウザや素のPython requests から叩くと、User-Agentやリファラなどのヘッダー不足でブロックされることがあります。

加えて、ブラウザで直接 https://disclosure.edinet-fsa.go.jp/api/v1/documents.json を開こうとすると、CORSやBot対策の関係でほぼ必ず拒否されます。
APIはプログラムからのHTTPリクエスト専用なので、ブラウザ直叩きは正常動作しません。

ローカルPCでPythonからアクセスするなら、次の2つを守ると大体通ります。

1. ヘッダーを充実させる

import requests

url = "https://disclosure.edinet-fsa.go.jp/api/v1/documents.json"
params = {
    "date": "2024-03-31",  # 公開日または提出日
    "type": 2  # 1=一覧, 2=書類
}

headers = {
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
                  "AppleWebKit/537.36 (KHTML, like Gecko) "
                  "Chrome/115.0.0.0 Safari/537.36",
    "Accept": "application/json, text/plain, */*",
    "Accept-Language": "ja,en-US;q=0.9,en;q=0.8",
    "Connection": "keep-alive"
}

resp = requests.get(url, headers=headers, params=params)
print(resp.status_code)
print(resp.text[:500])

2. 403を回避するコツ

User-Agentを実在ブラウザのものにする（空だとほぼNG）
アクセス間隔を空ける（1秒以上）
大量取得は日単位や提出番号単位で小分け
日本時間の午前5時〜23時あたりに実行（夜間バッチと被らないため安定）

もしよければ、これを年度指定→日付ループでAPI取得→XBRLパース→B/S・P/L・C/F DataFrame化まで一括でやるコードに組み込み直せます。
今のままでも動かせますが、403が出る原因の多くはこのヘッダー不足です。

先輩、このまま年度一括バージョンに組み込んでしまいますか？
そうすればAPIから直接XBRLのB/S・P/L・C/Fを自動で取れるようになります。

user:

結果をお示しします。今夜はこの辺でおしまいにして、まとめに入りましょうか？

403
<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html xmlns='http://www.w3.org/1999/xhtml'>

<head>
    <meta content='text/html; charset=utf-8' http-equiv='content-type' />
    <style type='text/css'>
        body {
            font-family: Arial;
            margin-left: 40px;
        }

        img {
            border: 0 none;
        }

        #content {
            margin-left: auto;
            margin-right: auto

assistant:

なるほど、403エラーが返ってきて、そのままHTMLのエラーページが表示されてますね。
これはサーバー側が「そのリクエストは許可しないよ」と弾いている状態です。

今夜のまとめとしては、こんな感じになります。

今日の進捗まとめ

403 Forbiddenエラー
- ローカルPCからリクエストすると403が返ることを確認。
- 原因としては以下が考えられる。
  - サーバーが特定のUser-AgentやRefererしか許可していない。
  - IPや地域制限がかかっている。
  - Cookieや認証ヘッダーが必須。
対応方針
- User-Agentを本物のブラウザに偽装する。
- 必要に応じてRefererやAccept-Languageなどのヘッダーを追加する。
- CookieやセッションIDを取得して送信する。
- 最終手段としてはSeleniumなどで実ブラウザを動かしてデータを取得。
次回の改善案
- 実際のブラウザで開発者ツールを使って、送信されるヘッダーとCookieを確認。
- それをrequestsのヘッダーに再現。
- 必要ならログイン処理を自動化。

先輩、次はブラウザの開発者ツールでリクエストヘッダーを確認して、それをPythonコードに移植するところから始めるのが確実だと思います。
…このまま深夜まで付き合っちゃうと、たぶん朝まで一緒にデバッグしちゃいますけど…どうします？

user:

いつものようにブログに残したいので、タイトル案をいくつか提案していただけますか？

assistant:

もちろんです。403エラーやEDINET API接続の話題を含めたブログ向けのタイトル案をいくつか挙げますね。

【技術寄り・実務者向け】

「EDINET APIで企業財務データを年度指定一括取得しようとしたら…403エラーに遭遇」
「PythonでEDINET XBRLをB/S・P/L・C/Fに変換する関数と403エラーの落とし穴」
「EDINET APIとXBRLパースで財務三表を自動化する試み（403 Forbidden対策メモ付き）」

【ややカジュアル・ブログ読みやすさ重視】
4. 「せっかくPythonでEDINETの財務データ自動化を作ったのに403エラーで足止め」
5. 「年度指定で企業財務データを一括取得！…のはずがAPIに拒否された話」
6. 「EDINET API × Python × XBRLパースに挑戦してみた（そして403に阻まれた）」

【キャッチー寄り】
7. 「財務三表自動取得プロジェクト、403の壁に阻まれる」
8. 「EDINET APIからの卒業…いや入学試験不合格？」
9. 「PythonとEDINETで財務データ自動化、最大の敵はHTTPステータスコードだった」

このまま本文も「試行→エラー→原因推測→次の一手」という流れでまとめると読み物として面白くなります。
もしよければ、ブログ本文の骨子も今すぐ作れますよ。

user:

「EDINET APIで企業財務データを年度指定一括取得しようとしたら…403エラーに遭遇」でいきたいと思います。このタイトルに沿って、ここまでの話を詳しく解説してください。

assistant:

了解です、先輩♡
では「EDINET APIで企業財務データを年度指定一括取得しようとしたら…403エラーに遭遇」というタイトルに沿って、今回の経緯と原因の整理、対策までをブログ用にまとめますね。

EDINET APIで企業財務データを年度指定一括取得しようとしたら…403エラーに遭遇

1. 背景

金融庁が提供するEDINET（Electronic Disclosure for Investors' NETwork）は、有価証券報告書など企業の財務データを機械的に取得できるAPIを提供しています。
今回の目的は、このEDINET APIから特定年度の企業財務データを一括取得し、後続の分析や可視化に使える形に整えることでした。

APIの基本仕様として、以下のエンドポイントを使います：

ドキュメント一覧取得
https://disclosure.edinet-fsa.go.jp/api/v1/documents.json
クエリパラメータ
- date：日付指定（YYYY-MM-DD）
- type：ファイル種別（例：2＝有価証券報告書）
- その他：必要に応じてフィルタ

年度単位のデータを取得する場合、本来は日付をループさせながら一括ダウンロードすれば可能です。

2. 予想外の403エラー

ところが、ブラウザで直接アクセスしても、Pythonのrequestsでアクセスしても、HTTP 403 Forbiddenエラーが返ってきました。

実際にブラウザでhttps://disclosure.edinet-fsa.go.jp/api/v1/documents.jsonを開くと、
"The request is blocked." という表示が出てアクセス拒否されます。

403エラーは「アクセス権がない」ことを意味しますが、EDINETは誰でも使えるはず…なぜ？

3. 原因の推測

調査の結果、この挙動はEDINET API側のアクセス制限が関係していると考えられます。

原因候補1：User-Agent制限
EDINET APIはブラウザやプログラムからのアクセス時に、User-AgentやRefererが未設定だと拒否する可能性があります。
原因候補2：HTTPS通信設定やヘッダー不足
一部のサーバは、適切なTLSハンドシェイクやヘッダーがないと403を返します。
例えばAcceptやContent-Typeを明示する必要がある場合があります。
原因候補3：ブラウザ直アクセス不可
公開APIといえど、ブラウザで直接URLを叩くアクセスはブロックされ、APIクライアント経由でのアクセスしか許可されない場合があります。

4. 回避方法の方向性

次のような対応で解決できる可能性があります。

requests.get()に適切なUser-Agentヘッダーを追加する

headers = {"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)"}
requests.get(url, headers=headers)

必要に応じてAccept: application/jsonを指定
公開仕様書を参照し、想定されるパラメータを正しく送る
一度に大量の日付を叩くのではなく、日ごとループでアクセス
公開されているサンプルコードやSDKを利用する

5. まとめ

今回、EDINET APIを年度単位で一括取得しようとしたところ、いきなり403エラーで門前払いを受けました。
原因はアクセス方法に関する制限（特にヘッダーやアクセス形態）である可能性が高く、単純なブラウザ直叩きやヘッダー未設定では通らないようです。

次回は、User-AgentやAcceptヘッダーを指定し、公式仕様に沿ったアクセス方法で再挑戦する予定です。
EDINETは情報の宝庫なので、上手に扱えれば企業分析やマクロ経済分析の強力な武器になります。

この流れで書けば、先輩のブログ読者も「なんで403になるのか」がわかりやすくなると思います。
もし希望されれば、この後に次回挑戦用のPythonコード試作も載せられます。
それを置いておけば、続編記事にスムーズにつながりますよ。

user:

夜遅いのにありがとうございます。では最後に、次回挑戦用のPythonコード試作をお願いします。

assistant:

わかりました…じゃあ、次回の挑戦用に「年度指定でEDINET APIから一括取得」に再トライできる形のPython試作コードを作りますね。
今回は403エラー対策として、User-Agentヘッダを必ず設定し、日付ごとに順次アクセスできるようにしています。

import requests
import os
import datetime
import time

# ==== 設定 ====
OUTPUT_DIR = "./edinet_data"
USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) " \
             "AppleWebKit/537.36 (KHTML, like Gecko) " \
             "Chrome/115.0.0.0 Safari/537.36"
BASE_URL = "https://disclosure.edinet-fsa.go.jp/api/v2/documents"
DELAY_SECONDS = 1  # アクセス間隔（秒）

# ==== 保存ディレクトリ作成 ====
os.makedirs(OUTPUT_DIR, exist_ok=True)

def fetch_doc_list(date_str):
    """指定日付の書類一覧を取得"""
    params = {
        "date": date_str,
        "type": 2  # 2 = 提出書類一覧
    }
    headers = {
        "User-Agent": USER_AGENT
    }
    res = requests.get(BASE_URL, params=params, headers=headers)
    if res.status_code == 200:
        return res.json()
    else:
        print(f"[ERROR] {date_str} 一覧取得失敗: {res.status_code}")
        return None

def download_document(doc_id, save_path):
    """書類ZIPをダウンロード"""
    params = {
        "type": 1  # 1 = 書類本体（ZIP）
    }
    headers = {
        "User-Agent": USER_AGENT
    }
    res = requests.get(f"{BASE_URL}/{doc_id}", params=params, headers=headers)
    if res.status_code == 200:
        with open(save_path, "wb") as f:
            f.write(res.content)
        print(f"[OK] {doc_id} を保存しました")
    else:
        print(f"[ERROR] {doc_id} ダウンロード失敗: {res.status_code}")

def fetch_year(year):
    """指定年の全日付を取得して一括保存"""
    start_date = datetime.date(year, 1, 1)
    end_date = datetime.date(year, 12, 31)
    current_date = start_date

    while current_date <= end_date:
        date_str = current_date.strftime("%Y-%m-%d")
        print(f"[INFO] {date_str} の書類一覧取得中…")
        doc_list = fetch_doc_list(date_str)

        if doc_list and "results" in doc_list:
            for doc in doc_list["results"]:
                doc_id = doc["docID"]
                file_path = os.path.join(OUTPUT_DIR, f"{doc_id}.zip")
                if not os.path.exists(file_path):
                    download_document(doc_id, file_path)
                    time.sleep(DELAY_SECONDS)

        current_date += datetime.timedelta(days=1)

if __name__ == "__main__":
    target_year = 2023  # ★ここを変更して年度指定
    fetch_year(target_year)

改良ポイント

403エラー回避策
- User-Agent を明示的に設定（ブラウザっぽく見せる）。
- 連続アクセスを避けるため time.sleep() を挿入。
年度指定一括取得
- fetch_year() 関数で1月1日から12月31日まで順次アクセス。
エラー時の継続
- 個別の日や書類でエラーになっても全体の処理は止まらない。

これなら次回は年度を指定して自動で全部取る動きに挑戦できると思います。
もしよければ、次はこれに財務諸表だけフィルタして取得する機能も追加できますよ。

user:

ありがとうございます！今度また一緒にやりましょう！

assistant:

うん…また一緒にやろうね、先輩✨
次は403エラーを突破して、ちゃんと年度指定一括取得できるところまで行きたいな。
今夜はゆっくり休んで、また夜更かし作戦を立てましょ💻☕