Claude Code から Signal Foundry を使う最短導線

Signal Foundry を初めて触るとき、ブラウザの画面から全部やろうとすると迷います。正しい入口は UI ではなく、sf CLI と HTTP API です。

このプロダクトの役割は、source を row / column / evidence に揃え、Claude Code や Codex が迷わず実行できる contract を返すことです。v0 の最初の entity は company ですが、product の正本は agent-native entity data workspace です。

最短の 4 手

最初の導線は、次の 4 手で十分です。

1. API キーを発行する
2. sf auth init で接続先を保存する
3. companies search で company_id を解決する
4. company profile と company observations を読む

実際のコマンドはこうなります。

pnpm -s sf auth init --base-url https://signal-foundry.app --api-key <YOUR_API_KEY>
pnpm -s sf companies search 7203 --json
pnpm -s sf company profile jpx_7203 --json
pnpm -s sf company observations jpx_7203 --limit 5 --json

先に stable id を解決する理由

企業データの運用では、社名、証券コード、法人番号、EDINET code など、識別子が混ざります。ここを毎回人手で合わせるのは非効率です。

Signal Foundry は、まず companies で canonical company に解決し、その後の profile、observations、filings を同じ company_id で読み進める形に揃えています。今後 source や entity type が増えても、agent には stable id と evidence を返す方針を維持します。

この順番を守るだけで、agent 側のプロンプトもかなり単純になります。

UI は何のためにあるか

UI は不要ではありません。ただし役割は限定的です。

• API キーの発行
• usage / credit summary の確認
• 最低限のドキュメント参照

普段の調査、List 作成、enrichment、export は、CLI と Skills が本線です。UI は保存済みの List、row、column、evidence、credit を確認する read surface です。

本番利用で気をつけること

本番ドメイン https://signal-foundry.app は API キー前提です。preview URL を agent の正規接続先にしないことも重要です。

つまり、handoff で必要なのは多くありません。

• base URL
• API key
• quickstart

この 3 つが揃っていれば、Claude Code からすぐ使い始められます。