1社調査

1 社を深掘りするときは、まず company_id を解決し、その後に Company Card と必要な Signals だけを確認します。filing detail / compare は、事前生成された IR Signals の裏取りが必要な場合だけ使う supporting evidence です。

いつ使うか

• 社名、証券コード、法人番号、domain から 1 社を特定したい
• 会社の現在地、観測データ、IR evidence を同じ company_id で読みたい
• 事前生成された Company Card / Signals を根拠付きで確認したい
• 必要な会社だけ signal evidence を確認したい

市場探索や競合候補の拡張はこのワークフローの主導線ではありません。候補群が必要な場合は Company Search で検索し、agent 側で local list に整形します。

会社-first

エージェントはまず 会社 identity を解決します。

sf company search 7203 --json
sf company profile <companyId> --json

見る key:

• company.company_id
• profile
• source_coverage
• suggested_next_commands

artifacts[] と raw は互換・詳細 機能です。通常の handoff では top-level field を読み、足りない場合だけ下の raw command に降ります。

Resolve company_id

まず検索して canonical company_id を確定します。

sf company search "<company name>" --json

見る key:

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

候補が複数ある場合は、社名だけで決めず、証券コード、法人番号、domain のどれかで再検索します。

sf company search 7203 --json

company_id が確定するまで、profile や signal 読み取りに 自由入力を渡さないでください。

Read profile

解決済み company_id で profile を読みます。

sf company profile <companyId> --json

見る key:

• company
• company.company_id
• company.display_name
• identifiers[]
• identifiers[]
• profile.profile
• profile.website_domain

profile は会社の現在地を確認する入口です。ここで identifier と website domain を確認してから、observations に進みます。

Read observations

同じ company_id で 根拠付きの observations を確認します。

sf company observations <companyId> --limit 5 --json

必要なら 取得元 や type で絞ります。

sf company observations <companyId> --source edinet --type corporate_profile --limit 5 --json

見る key:

• observations[]
• observations[].source
• observations[].type
• observations[].summary
• observations[].confidence
• observations[].evidence

observations は根拠付きの観測です。市場全体や競合候補を広げたい場合は、このページではなく market / competitor ワークフロー に移ります。

Read IR evidence

IR Signals の根拠が必要なときだけ、EDINET filing evidence の入口を確認します。

sf company filings <companyId> --limit 5 --json

annual report だけ見たい場合は document type を指定します。

sf company filings <companyId> --document-type annual_report --limit 5 --json

見る key:

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

filing が空の場合は 絞り込みを外して再取得してください。通常 workflow では、この一覧を Company Card / IR Signals の裏取りに使います。

sf signals <companyId> --include ir --json

見る key:

• signals.ir
• filings[]
• source_coverage
• gaps[]
• error.suggested_next_commands

Notes

現行 公開 CLI では、外部調査メモを直接保存する research 機能は公開していません。必要な根拠は Company Card、Signals、company observations、company filings の結果として確認します。

• item.promotion_status
• meta.created

保存前に company_id を必ず解決します。会社に紐付かない list-範囲d research は現行 公開ワークフロー の主導線ではありません。

確認する key

このワークフロー 全体では、次の key を順番に確認します。

• items[].company_id
• company
• profile
• source_coverage
• identifiers[]
• observations[]
• filings[]
• item.research_item_id
• error.suggested_next_commands

If it fails

company_not_found が返る場合:

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

too_many_candidates または候補が多すぎる場合:

1. 証券コードや法人番号で sf company search <identifier> --json を実行します。
2. query_match.identifier_matched を確認します。
3. 自動で 1 社に決めず、人間に候補を確認してください。

filing_not_found が返る場合:

1. sf company filings <companyId> --limit 10 --json を実行します。
2. filings[].filing_id と filings[].document_type を確認します。
3. 対象 filing がない場合は、document type 絞り込みを外します。

どの失敗でも、error.hint と error.suggested_next_commands が返る場合はその順に従います。unsupported や needs_human を silent 0 件にしないでください。

Next

• 1 社の CLI リファレンス を確認する: 会社 Profile / Observations / Filings
• 会社 search 入出力 を確認する: 会社検索
• 開示 evidence 入出力 を確認する: 開示一覧 API