概要

Data Capability Map

Signal Foundry で実際に利用できる data source、filter、API、CLI surface を、実装と `sf data capabilities --json` ベースで確認するためのページです。

このページの内容13項目

このページは、古くなりやすい surface の確認場所です。docs の文章より、まず実行中の CLI と API が返す contract を優先します。

最初に必ず次を実行してください。

sf version --json --check-update
sf auth show --json
sf data capabilities --json

確認する key:

version
update.update_available
effectiveBaseUrl
effectiveApiKeyPreview
configPath
contract_version
capabilities[].source_id
capabilities[].status
capabilities[].filters[]
capabilities[].entrypoints[]
capabilities[].pricing
capabilities[].limitations[]
deferred_surfaces[]

2026-05-06 時点で確認した CLI は 0.2.18、capability contract は 2026-05-01 です。ただし、このページの固定値を正本にせず、実行時の sf data capabilities --json を正本にしてください。

Status の読み方

Status	扱い
`supported`	通常 workflow で使える。保存や credit 消費前は estimate / preview を見る
`available`	public surface として使える
`partial`	範囲や coverage gap を説明してから使う
`weak`	0 件成功にしない。根拠の弱さを人間に返す
`unsupported`	実行しない。代替条件か follow-up に切る
`planned` / `deferred`	現在の public workflow の前提にしない
`needs_human`	保存、外部調査、credit 消費に進まない

Current Data Sources

Source	Status	使えること	主な filter / entrypoint	注意
`company_master`	supported / available	canonical company、identifier、profile を読む	`company_id`, `corporate_number`, `listing_status`, `market_segment`, `industry_33_code`, `website_domain`, `has_website`; `companies search`, `company profile`	company API だけを product 定義にしない
`company_registry`	supported / partial	日本企業 universe の探索、地域・業種・規模・Web有無の粗い絞り込み	`prefecture`, `city`, `industry_keywords`, `business_keywords`, `employee_number`, `capital_stock`, `date_of_establishment`, `registry_status`, `source_flags`	source of truth ではない。保存前に materialize / evidence 確認へ進む
`user_imported_source`	supported / available	CSV / 外部 source row を company に正規化する	`sf source import/inspect/map/resolve/review/select`, `sf list create --from-source`	`multiple_candidates` は agent が勝手に確定しない
`edinet_financial_facts`	supported / available	EDINET 財務指標で会社群を絞る	`metric_key`, `metric_scope`, `relative_year`, `revenue_threshold`, `operating_income_threshold`, `ordinary_income_threshold`, `profit_before_tax_threshold`, `net_income_threshold`, `total_assets_threshold`, `net_assets_threshold`	指標は `revenue`, `operating_income`, `ordinary_income`, `profit_before_tax`, `net_income`, `total_assets`, `net_assets`
`listing_events`	supported / available	上場イベント、上場日、市場区分で絞る	`event_type`, `listing_date`, `market_segment`, `exchange`, `source_id`	JPX / TOKYO PRO 中心。地方取引所は coverage gap として扱う
`observations`	weak / partial	テーマ語の横断 evidence を探す	`source`, `type`, `subtype`, `industry`, `market_segment`, `technology`, `website_domain`, `has_website`	`generative_ai`, `genai`, `llm`, `ai_agent` は technology alias として使える
`edinet_text_sections`	weak / partial	EDINET 本文 section の bounded search	`section_key`, `document_type`, `theme_text`	テーマ探索は evidence 確認用。保存条件は supported filter に戻す
`list_workspace`	supported / available	estimate、saved List、refresh、diff、export、review の workspace	`estimate_id`, `list_id`, `status`, `refresh_cadence`, `diff_status`	preview は saved List ではない
`website_enrichment`	supported / partial	saved List row に公式サイト由来の column / evidence を足す	`sf list enrich <listId> --source website --estimate/--execute`	`found` row だけ課金対象。`not_found` / `no_data` は課金対象外
`parallel_external_adapter`	weak / live_available_with_key	narrowed saved List の外部補完	`sf list enrich <listId> --source parallel --estimate --limit <n>`	broad search / Find All の入口にしない
`external_research`	supported / available	company に紐づく補助調査 item を保存・一覧する	`company_id`, `list_id`, `source_type`, `promotion_status`; `sf research add/ls`	canonical observation への自動 promotion は含めない
`jobs`	unsupported / planned	queue / runtime job surface	なし	`sf job ...` CLI と `job artifact` は使えるが、汎用 jobs API は planned
`news`	unsupported / planned	news source	なし	代替として research item に明示保存する

Deferred surface は mcp、openapi_generation、large_agent_runtime です。docs や agent prompt では、これらを現行 product core として前提にしないでください。

Current Filters

Company Search

GET /api/signal-foundry/companies と sf companies search で使う主な条件:

Filter	Notes
`q`	証券コード、社名、corporate number、domain など
`limit` / `offset`	`limit` は `1..100`
`listing_status`	`listed`, `delisted`, `unknown`
`market_segment[]`	market segment の複数指定
`industry_33_code[]`	JPX 33 業種コード
`has_website`	`true` / `false`

List Definition

saved List の definition で使う主な条件:

Area	Fields
company filters	`company_ids`, `has_website`, `listing_status`, `market_segment`, `q`
observation filters	`company_ids`, `has_website`, `industries`, `market_segments`, `observation_subtypes`, `observation_types`, `sources`, `technologies`, `website_domains`, `query`
materialization	`limit`, `monitored_signals`, `observations_per_company`, `scan_limit`, `selected_columns`
schedule / status	`refreshCadence: manual

Observation Search

POST /api/signal-foundry/observations/search と sf observations search は、テーマ語と構造 filter を分けます。

Field	Notes
`query`	短いテーマ語。長い自然文条件を入れない
`filters.company_ids`	会社を固定する場合
`filters.sources`	EDINET / website など source を明示
`filters.technologies`	`generative_ai`, `genai`, `llm`, `ai_agent` など
`limit`	`1..100`
`observations_per_company`	`1..20`
`scan_limit`	最大 `10000`

Current CLI Surface

Family	役割
`auth setup/init/show`	base URL と API key の設定確認
`agent install`	Codex / Claude Code skill の配置
`version`	CLI version と更新確認
`data capabilities`	source / filter / pricing / limitation の正本
`job business-understanding/company-research/sales-list/watchlist-review`	agent-ready workflow artifact
`job artifact ls/show`	保存済み job artifact の再開
`list plan/estimate/candidates/materialize/enrich`	query-start の保存・enrichment
`list ls/show/preview/publish/export/refresh/diff/create`	saved List の確認、snapshot、diff、export、source / explicit company 由来保存
`discovery show/refine/materialize`	estimate 後の run を復元し、追加条件で絞り、保存する
`source import/inspect/map/resolve/review/select`	CSV / 外部 source の正規化
`observations search`	複数社をまたぐ evidence search
`research ls/add`	external research item の保存・一覧
`credits balance/summary`	credit 残高と ledger summary
`companies search`	company resolver
`company profile/observations/filings`	1 社の深掘り
`filing show/compare`	EDINET filing detail / compare
`feedback create`	要望・不具合を要約して送る

細かい option は CLI help を正本にしてください。

sf --help
sf list --help
sf source --help
sf job --help
sf observations search --help

Current API Surface

HTTP API は、既存 backend や batch から組み込むときに使います。Claude Code / Codex からは先に CLI を使います。

Company / Evidence

GET /api/signal-foundry/companies
GET /api/signal-foundry/companies/{companyId}/profile
GET /api/signal-foundry/companies/{companyId}/observations
GET /api/signal-foundry/companies/{companyId}/filings
GET /api/signal-foundry/companies/{companyId}/filings/{filingId}
GET /api/signal-foundry/companies/{companyId}/filings/{filingId}/compare
POST /api/signal-foundry/observations/search

List Workspace

GET /api/signal-foundry/lists
POST /api/signal-foundry/lists
GET /api/signal-foundry/lists/{listId}
POST /api/signal-foundry/lists/estimate
GET /api/signal-foundry/lists/candidates
POST /api/signal-foundry/lists/materialize
GET /api/signal-foundry/lists/{listId}/preview
POST /api/signal-foundry/lists/{listId}/publish
POST /api/signal-foundry/lists/{listId}/refresh
GET /api/signal-foundry/lists/{listId}/diffs/latest
GET /api/signal-foundry/lists/{listId}/export
PATCH /api/signal-foundry/lists/{listId}/status
PATCH /api/signal-foundry/lists/{listId}/schedule
GET /api/signal-foundry/lists/{listId}/suppressions
PATCH /api/signal-foundry/lists/{listId}/suppressions
PATCH /api/signal-foundry/lists/{listId}/diff-rows/{diffRowId}/review
PATCH /api/signal-foundry/lists/{listId}/diff-rows/{diffRowId}/exclusion
GET /api/signal-foundry/lists/{listId}/workspace-preferences
PATCH /api/signal-foundry/lists/{listId}/workspace-preferences
PATCH /api/signal-foundry/lists/{listId}/delivery
POST /api/signal-foundry/lists/{listId}/deliver
POST /api/signal-foundry/lists/run-due-refreshes
POST /api/signal-foundry/lists/run-pending-deliveries
POST /api/signal-foundry/lists/{listId}/enrichments/estimate
POST /api/signal-foundry/lists/{listId}/enrichments/run

delivery は saved List に対する advanced handoff です。approval workflow、CRM 同期、full monitor / alert を自動で始める surface ではありません。

Source / Research / Control

POST /api/signal-foundry/sources/import
GET /api/signal-foundry/sources/{sourceId}/inspect
POST /api/signal-foundry/sources/{sourceId}/map
POST /api/signal-foundry/sources/{sourceId}/resolve
GET /api/signal-foundry/sources/{sourceId}/review
POST /api/signal-foundry/sources/{sourceId}/select
GET /api/signal-foundry/research/items
POST /api/signal-foundry/research/items
GET /api/signal-foundry/research/external
POST /api/signal-foundry/research/external/estimate
POST /api/signal-foundry/research/external/fetch
GET /api/signal-foundry/job-artifacts
POST /api/signal-foundry/job-artifacts
GET /api/signal-foundry/job-artifacts/{artifactId}
GET /api/signal-foundry/credits/balance
GET /api/signal-foundry/credits
GET /api/signal-foundry/usage/summary
GET /api/signal-foundry/usage/credits
POST /api/signal-foundry/feedback

Credit Boundary

操作	Credit
`companies search`, profile, observations, filings	通常は消費しない
`list plan`, `list estimate`, `list candidates`	消費しない
`list materialize --execute`	saved row の Basic credit
`source resolve --execute`	matched row の Basic credit
`source select`	明示選択した row/company の Basic credit
`list enrich --source website --execute`	`found` row の enrichment credit
`list enrich --source parallel --execute`	実行対象 row / external adapter の credit
`list export`	消費しない
`credits balance`, `credits summary`	消費しない

credit-consuming write は、必ず --execute --max-credits <n> を付けます。HTTP API では execute: true と maxCredits / max_credits を付けます。

古い記述に当たった場合

このページや他の docs と、実行中の CLI / API response が矛盾する場合は、実行結果を優先してください。

sf version --json --check-update で CLI version を確認する。
sf data capabilities --json で対象 source と filter の status を確認する。
sf <surface> --help で command option を確認する。
weak / unsupported / needs_human の場合は、0 件成功として扱わず、条件を分け直す。
それでも判断できない場合は、sf feedback create "<title>" --details "<body>" --json で要約を送る。

概要