AgentFilings

AgentFilings

AI エージェント向けの、構造化された米国 SEC／EDGAR 提出書類データです。提出書類インデックス、XBRL 由来の業績データ、Form 4 のインサイダー取引を、HTTP と MCP の両方で、整った JSON として提供します。

x402（Base メインネット上の USDC、アカウント不要）による従量課金です。API キーの発行、サブスクリプションゲート、チェックアウト、Webhook を備えた定額のStripe サブスクリプションの仕組みも apps/api/src/billing/ に実装されていますが、本番環境では有効化されていません。

api.agentfilings.com で稼働中 · OpenAPI · llms.txt · MCP エンドポイントは https://api.agentfilings.com/mcp です。公式 MCP レジストリに com.agentfilings/mcp として登録されており、MCP サーバーカード、AI カタログ、発見用の x402 マニフェスト も用意されています。

# Free. Tells you what data exists before you spend anything.
curl "https://api.agentfilings.com/probe?ticker=AAPL"

実際に興味深い点

作業の大半は、SEC データで間違えやすい 3 つの点と、エージェントへの支払いで間違えやすい 1 つの点に費やしました。

修正再表示。 companyfacts は、報告した提出書類ごとに同じ期間を返します。企業が数値を修正再表示しても、置き換えられた値は API に残ります。ここでは各期間について、最初に見つかった値ではなく、最も新しく提出された値に照合しています。

会計期間の出所。 事実データの fy／fp フィールドが示すのは期間ではなく、提出書類です。前年の四半期を比較対象として示す 10-Q では、その古い期間にも、新しい提出書類の会計年度が付与されます。ここでは各期間について、最初に報告した提出書類のラベルを保持しています。benchmark/ では、これらがどの程度食い違うかを実行可能な形で測定できます。

企業の同一性。 SEC のティッカーマップが、組織再編後のシェル会社を指す場合があります。その会社はティッカーを保有していますが、財務データを提出していません。解決には CIK を権威ある識別子として使用し、us-gaap の事実データを報告していない企業のカバレッジを記録しないようにしています。

支払いのリプレイ。 x402 のすべての支払い証明は、支払い対象の特定のリソースに紐付けられるため、あるエンドポイントや MCP ツール向けに発行された証明を別のものに対してリプレイすることはできません。決済は冪等であり、EIP-712 ドメインはハードコードせず、USDC コントラクトからネットワークごとに読み取ります。

正直なカバレッジ

/probe は無料で、支払い不要の場合はそのように案内します。

{
  "ticker_coverage": {
    "covered": true,
    "endpoints_with_data": ["/filings/latest", "/earnings/summary"],
    "empty_endpoints": ["/insiders"],
    "hint": "Partial coverage. /filings/latest and /earnings/summary will return data. /insiders would return an empty result, so do not pay for those."
  }
}

提出書類のカバレッジはあっても、業績データは空の場合があります。たとえば IFRS に基づいて提出する海外発行体や、売上がまだない企業です。何も返さない呼び出しに課金すると、自動購入者を二度と取り戻せなくなるため、このサービスでは支払いを受ける前にその旨を伝えます。

構成

apps/api/          TypeScript / Hono — HTTP API + MCP server
  src/payments/    x402 v2: routes config, replay guard, idempotency, discovery
  src/billing/     Stripe rail: key issuance, subscription gate, checkout, webhook
  src/mcp/         MCP over streamable HTTP, paid tools
  src/repo/        Corpus access (Postgres in prod, local JSON in tests)
apps/ingest/       Python 3.12 — SEC ingestion, XBRL + Form 4 parsers
packages/shared/   Pricing table, x402 constants, response types
infra/migrations/  SQL schema
benchmark/         Standalone, runnable SEC XBRL correctness measurement
tests/             Cross-cutting, including the payment-security spec

packages/shared/src/pricing.ts は API サーフェスの唯一の情報源です。支払いミドルウェア、/probe、MCP ツール一覧、OpenAPI ドキュメントは、すべてここから生成されます。

開発

pnpm install
pnpm test        # vitest — api + shared
pnpm typecheck
pnpm lint
pnpm dev         # http://localhost:8080

curl localhost:8080/health
curl "localhost:8080/probe?ticker=AAPL"

支払いはデフォルトで無効になっているため、開発環境では有料ルートもそのまま利用できます。データ取り込みには SEC_CONTACT_EMAIL が必要です。SEC は User-Agent に連絡先を含めることを求めており、含まれていないリクエストをブロックします。.env.example と infra/DEPLOY.md を参照してください。

原則

• 無料で提供する内容は正直に伝えます。 /health と /probe は常に無料で、/probe がカバレッジを実際以上に示すことはありません。
• 提供できないものに課金しません。 未実装のエンドポイントに支払いゲートを設けることはありません。そうしないと、ミドルウェアが支払いを受け取った後に 404 を返してしまいます。
• パブリックドメインのデータのみを使用します。 SEC EDGAR のみです。ライセンス対象のデータセットや、スクレイピングした文字起こしデータは使用しません。
• 加盟店としてのみ運営します。 このサービスが第三者の資金を保有、送金、転送することはありません。

ライセンス

MIT。データはパブリックドメインの SEC EDGAR です。