データの出所
Signal Foundry が返す根拠、coverage、会社カードの扱いを確認します。
このページの内容9項目
このページは、Signal Foundry が返すデータの出所を確認するためのリファレンスです。
Signal Foundry は、会社、Company Card、signals と一緒に、根拠になる evidence を返します。エージェントは evidence と coverage を読み、取得範囲が弱い場合は 0 件成功として扱いません。
まず見るコマンド
sf search 7203 --json sf signals jpx_7203 --json sf search "生成AIに関連する上場企業" --json
見る key:
companies[].company.company_idobservations[].sourceobservations[].evidencecompanies[].reasonmeta.source_coveragemeta.coverage_warningsmeta.warnings[]warnings[]
source_coverage、meta.coverage_warnings、warnings[] が弱い場合は、共有や反復実行に進む前に人間へ制約を伝えます。
出所の種類
| 種類 | 何を表すか | 主な読み口 |
|---|---|---|
company_master | 正規化済みの会社 identity、listing membership、segment | Search、Company Card |
edinet_text_sections | 開示書類の本文 section / excerpt | Search、Signals |
edinet_financial_facts | 財務 fact と period。Gold 適用前は weak/pending | Search、Company Card、開示一覧 API |
listing_events | listing / delisting / market movement | Search、Company Card |
company_website | 会社 website 由来の profile / technology / case signal | Company Card、Signals |
job_boards | 求人 source-native rows と linked company context | sf job search、Search |
construction_license | 建設業許可と営業所明細 | sf construction search、Search |
credit の扱いは、出所の種類では変わりません。API / CLI の読み取りは 1 request credit / operation 0 です。詳細は クレジット表 を見ます。
公開ドキュメントでは、この種類を product claim ではなく、根拠の出所として扱います。
evidence の状態
| 状態 | 意味 | エージェントの扱い |
|---|---|---|
present | claim に対応する取得元 / 根拠がある | 出力に含めてよい |
empty | 値が存在しない、または未保存 | claim にしない |
evidence_gap | claim はあるが根拠が足りない | 人間へ gap を返す |
weak | 取得元のカバー範囲が弱い | 条件を分解して確認する |
unsupported | 機能が対応していない | silent 0 件にしない |
needs_human | 自動判断すると誤確定し得る | 人間へ候補と理由を返す |
0 件 と unsupported は別です。取得元のカバー範囲が足りない時は、0 件成功として扱いません。
ローカル出力と Saved Lists
sf search / sf job search / sf construction search の JSON は、エージェントがローカルの Markdown、CSV、アプリ用 JSON に変換できます。再利用する会社群は、確定した company_id だけを sf list でサーバー側の Saved List に保存できます。入力 CSV を丸ごとアップロードしたり、曖昧な候補を推測して保存したりしないでください。
sf search "大阪の製造業でAI求人あり" --json sf company <companyId> --json
残すべき項目:
company_iddisplay_namesource_coveragereason/why_includedevidencemeta.request_credit
CSV や手元リストを突き合わせる場合は、外側のエージェントやスクリプトが 1 行ずつ sf search で company_id を解決します。曖昧な候補は自動確定しません。詳しい判定と保存手順は 営業リストの名寄せ を見ます。
EDINET の根拠
EDINET 由来の text section と financial fact は、Signals の IR、開示一覧、会社横断の Search の根拠になります。
財務条件を確定的に扱う場合は、EDINET-backed facts を自然文 q で推測せず、company_query.v1 を生成して Company Query で実行します。free cash flow、approved ratio 以外の generic ratio、トレンド条件、四半期、search-data 行がない annual_YYYY selector は unsupported / gaps[] として扱い、0 件成功や Gold 確定セグメントとして説明しません。
sf signals jpx_7203 --include ir --json sf search "生成AIに関連する上場企業" --json
見る key:
filings[].filing_idfilings[].doc_idsections[].section_keysections[].excerptcompanies[].reasongaps[]warnings[]meta.source_coveragemeta.coverage_warnings
section excerpt は根拠確認用です。raw filing text を UI に長く表示しません。
website / technology signal
website 由来の signal は、Company Card と Signals の technology / web / cases で読みます。
sf company <companyId> --json sf signals <companyId> --include technology,web --json
見る key:
profile.website_domaincompany_card.signals[]case_studies[]customer_relations[]observations[].evidencemeta.source_coverage
データの層
Signal Foundry が返すデータと、調査の過程で生まれる情報は、次の 4 層で分けて扱います。
| 層 | 含まれるもの | 扱い |
|---|---|---|
| 正規化済みの会社データ | 会社、identifiers、profile、observations、filings | 再利用前提の正本 |
| 補助根拠 | Web 検索、crawl、PDF 抽出、手動メモ | 正本に混ぜない補助情報 |
| セッション成果物 | エージェントの一時要約や作業メモ | 恒久記録にしない |
| ローカル出力 | CSV、Markdown、spreadsheet、自社 DB | Signal Foundry の外で保持する |
補助根拠は、最初から正本の observation には昇格しません。取得元の品質が不均一で、再現性に差があり、昇格にはレビューが必要なためです。
coverage の境界
| 境界 | 扱い |
|---|---|
| v0 の対象 entity | 会社が起点。product definition は entity ワークスペース |
| 地方取引所やニッチな母集団 | coverage gap として扱う |
| 社名が曖昧な会社 | search で候補を固定する |
| unsupported な条件 | warnings[] / gaps[] を返し、人間に確認する |
| 外部の非公開 URL | 保存しない。公開取得元 URL か手動メモに分ける |
| 生の transcript、API key、顧客の secret | 保存しない |
coverage が弱い場合は、warnings[] / gaps[] と該当ワークフローの復旧手順へ戻ります。母集団、coverage、semantic tag の読み方は データカバレッジと semantic tag を見ます。
次に読むページ
- 会社検索の入口: Company Search
- coverage と semantic tag: データカバレッジと semantic tag
- observations: 市場調査
- クレジットの入出力: クレジット表
- API を直接使う: API 概要