会社プロフィール・事例・観測データ・開示

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

契約サマリー

このページは CLI リファレンスです。1 社調査を順番に進める場合は 1社調査 を使います。

先に company_id を解決する

sf 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 へ進まないでください。

会社 profile

sf company jpx_7203 --card --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 でも 会社解決は成功です。profile が薄い場合は、identifiers[] と company を読み、次に observations / filings で根拠を確認してください。

会社 cases

sf company cases jpx_6836 --limit 5 --relation-tier all --json

主な option:

• --limit <n>
• --case-limit <n>
• --customer-limit <n>
• --project-limit <n>
• --relation-tier <high_conf|primary|all>
• --offset <n>

まず見る key:

• customer_relations[].customer.company_name
• customer_relations[].relation_tier
• case_studies[].page_title
• projects[].project_name
• *.url
• meta.request_credit.credits_used
• meta.returned_case_studies
• meta.returned_customer_relations
• meta.returned_projects

customer_relations は顧客名・会社紐付けが取れている場合に一番価値があります。建設業では projects[] に案件名、用途、構造、規模、場所が入ることがあります。

会社 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 絞り込みを外して再実行します。複数社を横断して候補を見る場合は、sf search "<theme or criteria>" --json に戻り、必要な company_id だけ observations を読みます。

会社 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

Company Card / IR Signals の根拠を確認したい場合に、ここで filing_id か doc_id を見ます。filings[] が空の場合は --document-type を外して再実行してください。成果物が failed / expected の場合は、欠損扱いにせず EDINET retry の対象にします。

最短ループ

sf search 7203 --json
sf company jpx_7203 --card --json
sf company cases jpx_7203 --limit 5 --json
sf company observations jpx_7203 --limit 5 --json
sf company filings jpx_7203 --limit 5 --json

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

エラーと復旧

company_not_found が返る場合:

1. sf 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 で オプションを確認します。

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

次に進む先

• IR Signals を読む: sf signals <companyId> --include ir --json
• HTTP 入出力を確認する: Profile API, Company Cases API, 開示一覧 API
• 1 社調査ワークフロー を確認する: 1社調査