営業リスト作成の前段をやる

この workflow は、営業候補を「検索結果」ではなく、後から見直せる saved List と CSV に変えるための手順です。

Signal Foundry で最初に作るべき営業成果物は、次の 3 点です。

• saved List: 候補企業を固定した workspace
• enrichment columns: website 由来の追加情報
• export CSV: 営業チームや外部ツールへ渡すファイル

使う場面

• ICP に近い上場企業を条件で抽出したい
• 候補企業の website / EDINET evidence を確認してから保存したい
• 営業チームへ渡す CSV に、会社情報と追加情報を入れたい
• Claude Code / Codex に任せても、credit 上限と失敗時の戻り先を固定したい

成功状態

この workflow が成功したら、最後に次を確認できます。

1. Plan で条件を supported な形にする

営業条件をそのまま保存に進めず、まず plan を確認します。

sf list plan "上場企業のうち、売上100億以上" --json

見る key:

• plan.status
• resolved_definition
• plan.supported_conditions
• plan.weak_conditions
• plan.unsupported_conditions
• plan.needs_human

plan.status が weak / unsupported / needs_human の場合は保存に進みません。条件を market segment、industry、売上しきい値、上場状態、テーマ語のどれに分けるかを人間へ返します。

source coverage を確認したい場合は、保存前に sf data capabilities --json の capabilities[].source_id、capabilities[].status、capabilities[].filters[] も見ます。

2. 保存前に件数と credit を見積もる

sf list estimate "上場企業のうち、売上100億以上" --json

見る key:

• estimate.estimate_id
• counts.matched_companies
• billing.materialize.estimated_credits
• billing.available_enrichments
• resolved_definition
• resolved_definition.warnings

この時点では saved List は作られません。preview と estimate は保存前の判断材料です。

3. Candidate preview を見る

sf list candidates --from-estimate <estimateId> --json

見る key:

• meta.preview_is_free
• meta.exportable
• companies[].company_id_hint
• companies[].company_hint
• companies[].reason
• next_actions

meta.exportable は false です。candidate preview は保存判断用なので、CSV が必要なら次の materialize に進みます。

4. Basic row を保存する

保存は credit-consuming write です。必ず --execute と --max-credits を付けます。

sf list materialize \
  --from-estimate <estimateId> \
  --name "売上100億以上の上場企業" \
  --execute \
  --max-credits <estimatedCredits> \
  --json

見る key:

• list.list_id
• list.name
• list.row_count
• billing.credits_used
• billing.basic_companies
• input.estimate_id
• idempotency_key

Basic credit は保存した company row に対して発生します。max_credits_exceeded が返る場合は、query を狭めるか、見積もり以上の --max-credits で再実行します。

5. Website enrichment を見積もる

sf list enrich <listId> --source website --estimate --json

見る key:

• estimate.estimated_target_companies
• estimate.estimated_max_credits
• estimate.reusable_existing_companies
• preview_rows
• billing.charges_only_found

website enrichment は found の会社だけ credit を使います。reusable_existing_companies が多い場合は、既存 enrichment を再利用できます。

6. Website enrichment を実行する

sf list enrich <listId> \
  --source website \
  --execute \
  --max-credits <estimatedMaxCredits> \
  --json

見る key:

• run.run_id
• run.found_count
• run.not_found_count
• run.no_data_count
• run.skipped_count
• run.error_count
• billing.credits_used

found_count が想定より少ない場合は、export 前に not_found_count と no_data_count を見て、営業チームへ渡す前提を確認します。

7. CSV に出す

sf list export <listId> \
  --format csv \
  --output ./exports/sales-targets.csv \
  --json

見る key:

• export.path
• path
• export.row_count
• export.sha256
• sha256
• billing.credits_used

export は saved List から出力します。candidate preview は export できません。

UI で確認する場所

CLI で保存した後は、ブラウザで次を確認します。

1. /home/lists
2. saved List detail
3. row count
4. website enrichment columns
5. run history
6. credit usage

UI は read surface です。作成・保存・enrichment は CLI / API の JSON contract を正本として扱います。

失敗時の戻り先

Claude Code / Codex に渡す prompt

Signal Foundry で営業候補を saved List と CSV にしてください。

進め方:
1. `sf version --json --check-update`
2. `sf auth show --json`
3. `sf data capabilities --json`
4. `sf list plan "<criteria>" --json`
5. plan が weak / unsupported / needs_human なら保存せず、人間に条件の分解案を返す
6. `sf list estimate "<criteria>" --json`
7. `sf list candidates --from-estimate <estimateId> --json`
8. 保存するなら `sf list materialize --from-estimate <estimateId> --name "<name>" --execute --max-credits <estimatedCredits> --json`
9. `sf list enrich <listId> --source website --estimate --json`
10. 実行するなら `sf list enrich <listId> --source website --execute --max-credits <estimatedMaxCredits> --json`
11. `sf list export <listId> --format csv --output ./exports/sales-targets.csv --json`

返し方:
- `plan.status`, `resolved_definition`, `unsupported_conditions`, `weak_conditions`, `estimate_id`, `matched_companies`, `listId`, `row_count`, `run_id`, `run.found_count`, `path`, `sha256`, `credits_used` を短くまとめる
- unsupported / weak な条件を silent 0 件として扱わない
- API key や private URL は出さない

この workflow に含めないもの

• delivery handoff の実行
• approval workflow
• full monitor / alert
• external research の queue / retry / canonical promotion
• CRM への同期
• 営業メール作成

この workflow の責任範囲は、候補企業を保存し、website enrichment を足し、CSV に出すところまでです。