Signal Foundry
ドキュメント
サポート 戻る
ドキュメントユースケースAPI リファレンスリリースノート

概要

Agent が迷わず使える順に整理しています。

はじめに
sf CLI をインストールクイックスタート会社IDの見方データの出所カバレッジとタグ
認証
認証設定APIキーのライフサイクル利用状況の見方APIキー認証アカウントスコープは通常不要レート制限とエラー
請求
利用プラン利用量の計測クレジット表
CLI
CLI 概要CLI 認証基本コマンド会社検索求人検索会社・事例・観測・開示建設業許可検索ヘルプとエラーコマンドとフラグCLI 更新
トラブルシュート
会社が見つからないとき認証・接続・制限エラー低ヒット検索の見直し方プレビューURLの注意クレジットと maxCredits の失敗
概要

データの出所

Signal Foundry が返す根拠、coverage、会社カードの扱いを確認します。

このページの内容8項目
まず見る command出所の種類evidence の状態ローカルの表や CSVEDINET の根拠website / technology signalcoverage の境界次に読むページ

このページは、Signal Foundry が返すデータの出所を確認するためのリファレンスです。

Signal Foundry は、会社、Company Card、signals と一緒に、根拠になる evidence を返します。エージェントは evidence と coverage を読み、取得範囲が弱い場合は 0 件成功として扱いません。

まず見る command

sf company search 7203 --json
sf company observations jpx_7203 --limit 5 --json
sf company search "生成AIに関連する上場企業" --json

見る key:

  • companies[].company.company_id
  • observations[].source
  • observations[].evidence
  • companies[].reason
  • meta.source_coverage
  • meta.coverage_warnings
  • meta.warnings[]
  • warnings[]

source_coverage、meta.coverage_warnings、warnings[] が弱い場合は、共有や反復実行に進む前に人間へ制約を伝えます。

出所の種類

種類何を表すか主な機能credit 境界
company_master正規化済みの会社 identity、listing membership、segmentcompany search, profileAPI/CLI 読み取りは 1 request credit / operation 0
edinet_text_sections開示書類の本文 section / excerptcompany search, company observations, signals --include irAPI/CLI 読み取りは 1 request credit / operation 0
edinet_financial_facts財務 fact と period。Gold 適用前は weak/pendingcompany search, profile, filingsAPI/CLI 読み取りは 1 request credit / operation 0
listing_eventslisting / delisting / market movementcompany search, profileAPI/CLI 読み取りは 1 request credit / operation 0
company_website会社 website 由来の profile / technology / case signalprofile, cases, observationsAPI/CLI 読み取りは 1 request credit / operation 0
job_boards求人 source-native rows と linked company contextjob search, company search --has-jobsAPI/CLI 読み取りは 1 request credit / operation 0
construction_license建設業許可と営業所明細construction search, company search --constructionAPI/CLI 読み取りは 1 request credit / operation 0

公開ドキュメントでは、この種類を product claim ではなく、根拠の出所として扱います。

evidence の状態

状態意味エージェントの扱い
presentclaim に対応する取得元 / 根拠がある出力に含めてよい
empty値が存在しない、または未保存claim にしない
evidence_gapclaim はあるが根拠が足りない人間へ gap を返す
weak取得元のカバー範囲が弱い条件を分解して確認する
unsupported機能が対応していないsilent 0 件にしない
needs_human自動判断すると誤確定し得る人間へ候補と理由を返す

0 件 と unsupported は別です。取得元のカバー範囲が足りない時は、0 件成功として扱いません。

ローカルの表や CSV

v0 の公開導線では、CSV や手元リストを Signal Foundry に保存する前提にしません。sf company search / sf job search / sf construction search の JSON を、agent がローカルの Markdown、CSV、アプリ用 JSON に変換します。

sf company search "大阪の製造業でAI求人あり" --json
sf company profile <companyId> --card --json

残すべき項目:

  • company_id
  • display_name
  • source_coverage
  • reason / why_included
  • evidence
  • meta.request_credit

CSV や手元リストを突き合わせる場合は、外側の agent / script が 1 行ずつ sf company search で company_id を解決します。曖昧な候補は自動確定しません。

EDINET の根拠

EDINET 由来の text section と financial fact は、会社 observations、filings、cross-会社 search の根拠になります。

Financial filters を決定的に扱う場合は、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 company filings jpx_7203 --limit 5 --json
sf signals jpx_7203 --include ir --json
sf company search "生成AIに関連する上場企業" --json

見る key:

  • filings[].filing_id
  • filings[].doc_id
  • sections[].section_key
  • sections[].excerpt
  • companies[].reason
  • gaps[]
  • warnings[]
  • meta.source_coverage
  • meta.coverage_warnings

section excerpt は根拠確認用です。raw filing text を UI に長く表示しません。

website / technology signal

website 由来の signal は Company Card、cases、observations で読みます。

sf company profile <companyId> --card --json
sf company cases <companyId> --limit 5 --json
sf company observations <companyId> --source company_website --limit 5 --json

見る key:

  • profile.website_domain
  • company_card.signals[]
  • case_studies[]
  • customer_relations[]
  • observations[].evidence
  • meta.source_coverage

coverage の境界

境界扱い
v0 entity会社-first。product definition は entity ワークスペース
Local exchange / niche universecoverage gap として扱う
Ambiguous 会社 namecompany search で候補を固定する
Unsupported conditionwarnings[] / gaps[] を返し、人間に確認する
External private URL保存しない。公開取得元 URL か manual note に分ける
Raw transcript / API key / customer secret保存しない

coverage が弱い場合は、warnings[] / gaps[] と該当ワークフローの復旧手順へ戻ります。母集団、coverage、semantic tag の読み方は データカバレッジと semantic tag を見ます。

次に読むページ

  • 会社検索の入口: Company Search
  • coverage と semantic tag: データカバレッジと semantic tag
  • observations: 市場調査
  • クレジットの入出力: クレジット表
  • API を直接使う: API 概要

このページの内容

まず見る command出所の種類evidence の状態ローカルの表や CSVEDINET の根拠website / technology signalcoverage の境界次に読むページ