Company Research Workflow

1 社を深掘りするときは、まず company_id を解決し、その後に profile、observations、filings、compare の順で確認します。

いつ使うか

• 社名、証券コード、法人番号、domain から 1 社を特定したい
• 会社の現在地、観測データ、EDINET filing を同じ company_id で読みたい
• 最新 filing と前回 comparable filing の差分を確認したい
• 調査メモを company に紐付けて残したい

市場探索、競合候補の拡張、List materialization はこの workflow の主導線ではありません。候補群を保存する場合は List Workspace Loop に移ります。

Job-first

agent はまず job surface から入ります。

sf job company-research 7203 --execute --json

見る key:

• company_summary
• source_summary
• important_observations
• filings
• filing_detail
• evidence
• evidence_gaps
• next_actions
• suggested_next_commands

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

Resolve company_id

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

sf companies 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 companies search 7203 --json

company_id が確定するまで、profile や filings に free text を渡さないでください。

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 で evidence-backed observations を確認します。

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

必要なら source や 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 workflow に移ります。

Read filings

EDINET filing の入口を確認します。

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_id を選んでから、必要なら filing show で artifact / facts / segment metrics を確認し、その後 compare に進みます。filing が空の場合は filter を外して再取得してください。

sf filing show <companyId> <filingId> --fact-limit 1000 --json

見る key:

• filing.artifact_health
• filing.fact_stats
• filing.summary_metrics
• filing.segment_metrics

Compare filings when useful

前回比較が必要なときだけ compare を実行します。

sf filing compare <companyId> <filingId> --json

見る key:

• compare.summary_metrics
• compare.sections
• filings.current
• filings.against
• error.suggested_next_commands

比較先が自動解決できない場合は、sf company filings <companyId> --limit 10 --json に戻り、比較したい filing を選び直します。compare は 1 社の filing 差分を見るための導線で、競合比較表を自動生成する surface ではありません。

Save notes / research item if applicable

外部で読んだ IR メモや確認結果を残す場合は、research item として company に紐付けます。

sf research add <companyId> --title "IR note" --content-file ./note.md --json

見る key:

• item.research_item_id
• item.company_id
• item.promotion_status
• meta.created

保存前に company_id を必ず解決します。company に紐付かない list-scoped research は現行 public workflow の主導線ではありません。

確認する key

この workflow 全体では、次の key を順番に確認します。

• items[].company_id
• company_summary
• source_summary
• important_observations
• evidence
• evidence_gaps
• next_actions
• company
• identifiers[]
• observations[]
• filings[]
• compare.summary_metrics
• item.research_item_id
• error.suggested_next_commands

If it fails

company_not_found が返る場合:

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

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

1. 証券コードや法人番号で sf companies 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 filter を外します。

compare_target_not_found が返る場合:

1. sf company filings <companyId> --limit 10 --json を実行します。
2. filings[].previous_comparable_filing を確認します。
3. 比較先がない場合は compare を止め、単体 filing の確認に戻ります。

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

Next

• 1 社の CLI reference を確認する: Company Profile / Observations / Filings
• company search contract を確認する: 会社検索
• filing compare contract を確認する: 開示比較