Company Profile / Observations / Filings

company profile、company observations、company filings は、すべて解決済み company_id を前提に動きます。社名、自然文、曖昧な略称を直接渡さないでください。

契約サマリー

このページは CLI reference です。1 社調査を順番に進める場合は Company Research Workflow を使います。

先に company_id を解決する

sf companies search "7203" --json

見る key:

• items[].company_id
• companies[].company.company_id
• companies[].query_match.identifier_matched
• meta.returned_companies
• error.suggested_next_commands

候補が複数ある場合は、証券コード、法人番号、domain のどれかで再検索します。company_id が確定するまで、profile / observations / filings へ進まないでください。

company profile

sf company profile jpx_7203 --json

まず見る key:

• company.company_id
• company.display_name
• company.industry_33
• identifiers[]
• profile.profile
• profile.website_domain
• profile.latest_observed_at
• meta.has_profile

meta.has_profile=false でも company 解決は成功です。profile が薄い場合は、identifiers[] と company を読み、次に observations / filings で evidence を確認してください。

company observations

sf company observations jpx_7203 --limit 5 --json
sf company observations jpx_7203 --source edinet --type corporate_profile --limit 5 --json

主な option:

• --limit <n>
• --offset <n>
• --source <value[,value]>
• --type <value[,value]>
• --subtype <value[,value]>

まず見る key:

• observations[].observation_id
• observations[].source
• observations[].type
• observations[].summary
• observations[].confidence
• observations[].evidence
• meta.returned_observations
• meta.has_more

0 件の場合は、source / type / subtype filter を外して再実行します。複数社を横断してテーマ探索する場合は、sf observations search "<theme>" --json に切り替えます。

company filings

sf company filings jpx_5574 --limit 5 --json
sf company filings jpx_5574 --document-type annual_report,semi_annual_report --json

主な option:

• --limit <n>
• --offset <n>
• --document-type <value[,value]>

まず見る key:

• filings[].filing_id
• filings[].doc_id
• filings[].document_type
• filings[].period_end
• filings[].submitted_at
• filings[].artifact_health
• filings[].fact_stats
• filings[].summary_metrics
• filings[].previous_comparable_filing
• meta.returned_filings

filing show や filing compare に進む前に、ここで filing_id か doc_id を選びます。filings[] が空の場合は --document-type を外して再実行してください。artifact が failed / expected の場合は、欠損扱いにせず EDINET retry の対象にします。

最短ループ

sf companies search 7203 --json
sf company profile jpx_7203 --json
sf company observations jpx_7203 --limit 5 --json
sf company filings jpx_7203 --limit 5 --json

この順番を守ると、company_id、現在地、evidence、filing 候補を同じ company に固定できます。

エラーと復旧

company_not_found が返る場合:

1. sf companies search <query> --json に戻ります。
2. items[].company_id または companies[].company.company_id を確認します。
3. 候補が 0 件の場合は、社名、証券コード、法人番号、domain のどれかに分解してください。

invalid_query が返る場合:

1. --limit, --offset, --source, --type, --document-type を確認します。
2. comma-separated value に空要素が入っていないか確認します。
3. sf company observations --help または sf company filings --help で option を確認します。

rate_limit_exceeded が返る場合は、error.rate_limit.retryAfterSeconds または Retry-After に従って待機します。

次に進む先

• filing の中身を読む: Filing Show / Compare
• HTTP contract を確認する: Profile API, 開示一覧 API
• 1 社調査 workflow を確認する: Company Research Workflow