sn-search-year-report

年次報告検索

認証情報の設定

API key、token、cookie は、リポジトリのルートディレクトリにある .env（.env.example を参照）にまとめて記載し、実行前に runtime またはユーザーが同名の環境変数として読み込むことを推奨します。スクリプトは引き続き、環境変数または明示的な CLI 引数からのみ認証情報を読み込みます。実際の秘密情報を skill payload、レポート、ログに記載したり、コミットしたりしないでください。

無料で、公式で、通常どおりアクセスできる年次報告書、年次決算書、定期報告書の情報源のみを使用してください。商用データベース、サブスクリプション、試用枠、有料ダウンロード、ログイン画面、CAPTCHA、保護ページ、アクセスできないページに遭遇した場合は、直ちに破棄し、制限を回避しないでください。

出力には、会社／証券コード、報告期間、ファイルタイトル、開示日、PDF または詳細ページの URL、情報源の名称を記載してください。

ワークフロー

1. まず主体の種類を判断します：A 株／香港株／米国株／英国企業／日本の上場企業／債券発行主体／カナダ／シンガポール／オーストラリア。
2. scripts/year_report_api.py と browser-use は併用できます。スクリプトは構造化された検索に、ウェブページはサイト内での絞り込み、ページの確認、公開 PDF のダウンロードに適しています。
3. スクリプトが対応していない情報源や、対話的な絞り込みが必要な情報源は、browser-use で以下の表のウェブページを開き、サイト内検索、公告カテゴリの絞り込み、PDF または詳細ページの特定を行います。
4. 公式開示情報源のみを受け入れます。企業公式サイトの IR ページは補足として利用できますが、公式情報源の代わりにはなりません。
5. 中国の一般的な非上場企業は、通常、完全な財務年次報告書を公開していません。工商年報は監査済み財務報告書ではなく、本スキルでは安定してアクセスできない工商公示システムをすでに除外しています。

API スクリプト

スクリプトの場所：scripts/year_report_api.py。Python 標準ライブラリのみを使用します。

python scripts/year_report_api.py cninfo "平安银行" --year 2023 --page-size 5
python scripts/year_report_api.py sec-company apple --limit 5
python scripts/year_report_api.py sec-filings --ticker AAPL --limit 5
python scripts/year_report_api.py download "https://static.cninfo.com.cn/finalpage/2024-03-15/1219306493.PDF" --output report.pdf

コマンド	無料での利用	用途
cninfo	無料、key 不要	巨潮資訊の A 株公告。デフォルトでは年次報告書 PDF を検索
sec-company / sec-filings	無料、key 不要	SEC EDGAR の企業 CIK、10-K/20-F/40-F 年次報告書ファイル
download	無料の公開 URL	スクリプトが返す公開 PDF をダウンロード

cninfo --year は報告期間の年を指定します。スクリプトは翌年の開示期間を自動的に検索します。開示日を正確に絞り込む場合は、--date-range を使用してください。

スクリプトには key 不要のインターフェースのみを残します。API key、token、登録ログイン、サブスクリプションが必要なインターフェースは、スクリプトに追加しないでください。

Browser-use の情報源

以下の情報源を、無料の公式ウェブページの入口として使用します。タスクに応じて API スクリプトと併用してください。

対象	情報源	URL	使用時のポイント
A 株の全市場	巨潮資訊	https://www.cninfo.com.cn/new/index?lang=zh	会社名／証券コードで検索し、「年度報告」を絞り込み
上海市場の上場企業	上海証券取引所の定期報告書	https://www.sse.com.cn/disclosure/listedinfo/regular/	証券コード、年、定期報告書で絞り込み
深セン市場の上場企業	深セン証券取引所の上場企業公告	https://www.szse.cn/www/disclosure/notice/company/	会社、公告の種類、期間で絞り込み
北京証券取引所の上場企業	北京証券取引所の情報開示	https://www.bse.cn/disclosure/announcement.html	年次報告書／定期報告書を検索
香港株	HKEXnews 定義済み文書	https://www1.hkexnews.hk/search/predefineddoc.xhtml	Annual Report / Environmental, Social and Governance Information を選択
中国の債券発行主体	中国貨幣網の債券情報開示	https://www.chinamoney.org.cn/chinese/zqfx/	発行主体の年次報告書、監査報告書、モニタリング格付けを検索
中国の債券発行主体	上海清算所	https://www.shclearing.com.cn/	発行主体の年次報告書／監査報告書を検索
中国の債券発行主体	上海証券取引所の債券情報開示	https://bond.sse.com.cn/disclosure/	債券発行主体の年次報告書を検索
英国企業の決算書	Companies House のウェブページ	https://find-and-update.company-information.service.gov.uk/	API key がない場合は filing history / accounts を検索
カナダの上場企業	SEDAR+ Documents Search	https://www.sedarplus.ca/csa-party/service/create.html?_locale=en&service=searchDocuments&targetAppCode=csa-party	Documents を選び、issuer/profile と annual filings で検索
シンガポールの上場企業	SGX Company Announcements	https://www.sgx.com/securities/company-announcements	Annual Report または会社コードで検索
オーストラリアの上場企業	ASX Announcements	https://www.asx.com.au/markets/trade-our-cash-market/announcements	ASX コードと announcement type で検索

除外済み

情報源	理由
国家企業信用情報公示システム https://www.gsxt.gov.cn/	工商年報に関連しますが、アクセスがブロックされているため、安定した無料情報源として扱いません
市場監督管理総局の説明ページ	政策の説明にすぎず、年次報告書の検索ページではありません
Companies House API、EDINET API	API key が必要なため、スクリプトには含めません
商用データベースまたは有料 API	無料の公式情報源という要件に適合しません

出力規則

PDF を特定できる場合は PDF を提示し、PDF がない場合は公式の詳細ページを提示してください。報告書の種類の違いを説明してください。工商年報、上場企業の年次報告書、SEC 10-K/20-F/40-F、Companies House accounts、債券発行主体の年次報告書は、開示基準が同じではありません。