List Workspace Loop

List Workspace Loop は、候補会社を見つけるだけで終わらせず、保存し、追加情報を足し、必要なら CSV で渡せる状態まで持っていくための繰り返しです。

CSV や外部 source から始める場合は、先に Source Import Workflow で source row を company に resolve し、saved List を作ってからこの loop に戻ります。

When To Use

次の状態になったら、このページを使います。

• natural language query から候補会社を保存したい
• market / competitor research の候補を saved List にしたい
• source import 後に saved List へ enrichment と export を足したい
• Claude Code / Codex に保存、追加情報、CSV export まで任せたい

1 社だけを調べる場合は Company Research Workflow を使います。CSV から始める場合は Source Import Workflow を使います。

Success State

成功状態:

• estimate.estimate_id が返っている
• candidates で保存前 preview を確認している
• list.list_id を持つ saved List ができている
• list show で saved row projection の website URL/domain と why_now を確認している
• 必要な enrichment run が run.run_id を返している
• CSV export が path / row_count / sha256 を返している
• credit-consuming write はすべて --execute --max-credits 付きで実行している

確認する key

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

• capabilities[].source_id
• capabilities[].status
• capabilities[].filters[]
• plan.status
• estimate.estimate_id
• counts.matched_companies
• billing.materialize.estimated_credits
• companies[].company_hint
• list.list_id
• list.row_count
• companies[].website_url
• companies[].website_domain
• companies[].preview_sources
• companies[].source_types
• companies[].why_now_summary
• estimate.estimated_max_credits
• run.run_id
• run.found_count
• billing.credits_used
• path
• row_count
• sha256

Standard Loop

1. Capabilities And Plan

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

見る key:

• capabilities[].source_id
• capabilities[].status
• capabilities[].pricing
• plan.status
• resolved_definition
• unsupported_conditions
• weak_conditions

plan.status が weak / unsupported / needs_human の場合は、保存へ進まず条件を分け直します。

2. Estimate

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

見る key:

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

Estimate は保存しません。ここで credit と母集団を確認します。

3. Candidates

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

見る key:

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

candidate preview は無料ですが export できません。CSV が必要なら materialize します。

4. Materialize

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

見る key:

• list.list_id
• list.row_count
• billing.credits_used
• billing.basic_companies

materialize は saved List を作る write です。--execute --max-credits なしで進めないでください。

materialize 後は row projection を確認します。

sf list show <listId> --json

見る key:

• companies[].website_url
• companies[].website_domain
• companies[].preview_sources
• companies[].source_types
• companies[].why_now_summary

website が無い会社も saved row です。generic websearch で勝手に補完せず、必要な場合だけ enrichment estimate に進みます。

5. Enrichment Estimate

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

6. Enrichment Run

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

enrichment は found result に対して credit を使います。estimate せずに run へ進まないでください。

Parallel で最新情報を足す場合も、candidate set を saved List に固定してから見積もります。

sf list enrich <listId> --source parallel --estimate --limit 10 --json
sf list enrich <listId> --source parallel --execute --limit 10 --max-credits 10 --json

Parallel は broad search / Find All の入口ではありません。saved List に絞った後の external enrichment です。

7. Export

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

見る key:

• path
• row_count
• sha256
• billing.credits_used

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

Parallel enrichment 済みの CSV では次の列も確認します。

• parallel_enrichment_status
• parallel_enrichment_summary
• parallel_enrichment_reason
• parallel_enrichment_query
• parallel_enrichment_urls
• parallel_enrichment_signals

What Changes

UI Checks

ブラウザでは次を確認します。

1. /home/lists
2. list detail
3. rows
4. enrichment columns
5. run history
6. credit usage

UI は read surface です。作成や復旧は CLI / API で JSON を確認して進めます。

If It Fails

Agent Prompt

Signal Foundry を使って saved List を作り、website enrichment と CSV export まで進めてください。

進め方:
1. `sf version --json --check-update`
2. `sf auth show --json`
3. `sf data capabilities --json`
4. `sf list plan "<criteria>" --json`
5. `sf list estimate "<criteria>" --json`
6. `sf list candidates --from-estimate <estimateId> --json`
7. `sf list materialize --from-estimate <estimateId> --name "<name>" --execute --max-credits <estimatedCredits> --json`
8. `sf list show <listId> --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 enrich <listId> --source parallel --estimate --limit <n> --json`
12. 必要な場合だけ `sf list enrich <listId> --source parallel --execute --limit <n> --max-credits <n> --json`
13. `sf list export <listId> --format csv --output ./exports/list.csv --json`

ルール:
- `estimate_id` と `list_id` を途中で必ず表示する
- `list show` で website URL/domain と why_now を確認する
- `materialize` と `enrich` の credit 見積もりを必ず表示する
- Parallel は saved List 固定後だけ使い、export では `parallel_enrichment_*` 列を確認する
- `weak` / `unsupported` / `needs_human` を silent success にしない
- delivery handoff や full monitor は明示依頼がない限り触らない

Next

• query から営業候補を作る: 営業リスト作成の前段
• CSV から始める: Source Import Workflow
• HTTP API contract を確認する: リストAPI
• credit failure を直す: GET /credits/balance