Edgrapi — US Government Data API

edgrapi-skills

AI エージェント向けの米国政府データ — 5 つの公式ソース、1 つのキー、1 つの JSON スキーマ。

SAM.gov の契約機会、USAspending の受賞情報、Grants.gov の助成金、米国下院 STOCK Act の取引、 SEC EDGAR の提出書類を、ホスト型 MCP サーバーとすぐに使える Python スキルとして、 Edgrapi API 経由で提供します。

これらのソースはすべて無料で公開されています。どのソースにも、それぞれ厄介な点があります。SAM.gov は naics を指定すると思われるところで ncode を要求し、不明なフィルターを黙って無視します。日付形式は MM/dd/yyyy で、検索期間は 1 年が上限です。USAspending は実際のレコードが 50,000 件まで続いていても、10,000 件で hasNext が false になります。EDGAR では XBRL タグの揺れに悩まされます。Edgrapi はこれらすべてを 1 つのスキーマに正規化するため、エージェントは 1 回の呼び出しで信頼できる数値を取得できます。

無料で始められます — キーを取得すれば、最初に 50 クレジットが付与されます。カードは不要です。

Python 標準ライブラリのみを使用します。依存関係はありません。MIT-0 ライセンスです。

最速の方法：ホスト型 MCP サーバー

インストールもローカルプロセスも不要です。任意の MCP クライアントから 1 つの URL に接続します。

{
  "mcpServers": {
    "edgrapi": {
      "url": "https://api.edgrapi.com/mcp",
      "headers": { "Authorization": "Bearer edgr_YOUR_KEY" }
    }
  }
}

Claude Desktop、Claude Code、Cursor、Cline で動作します。トランスポートは streamable-http です。認証には bearer edgr_ キー、または PKCE を使った OAuth 2.1 を使用できます。サーバー自体がプロバイダーであり、動的なクライアント登録をサポートしています。ディスカバリー（initialize、tools/list）は公開されているため、キーを取得する前にツールの全リストを確認できます。tools/call にはキーが必要です。

その他の利用方法

# Python client
pip install edgrapi

# Docker — the MCP server as a container
docker run -e EDGRAPI_API_KEY=edgr_... ghcr.io/paperandbeyond23-gif/edgrapi-mcp:latest

# Python skills from this repo, via the skills CLI
npx skills add paperandbeyond23-gif/edgrapi-skills --all
npx skills add paperandbeyond23-gif/edgrapi-skills --skill edgrapi-full

io.github.paperandbeyond23-gif/edgrapi-skills として 公式 MCP レジストリにも登録されています。

MCP サーバーが対応する内容

読み取り専用のツールが 19 個あります。

ソース	ツール	クレジット
SAM.gov	get_opportunities — NAICS、セットアサイド、州、種別による契約機会	2
USAspending	get_awards — 契約、助成金、融資、直接支払い	2
Grants.gov	get_grants — CFDA 番号と締め切りを含む資金提供機会	2
Congress	get_congress — 米国下院 STOCK Act の株式取引	2
SEC EDGAR	get_insider（Form 4、クラスター買い検出付き）、get_holdings（13F、四半期ごとの差分）、get_activist（5%超の持ち分を示す 13D/G）、get_events（種別分類済み 8-K）、get_fundamentals、get_ratios、get_sections、get_company、get_filings、XBRL から JSON への変換、エンティティ解決、全文検索	1–5

最新の一覧は tools/list を呼び出すか、 サーバーカードをお読みください。どちらもサーバーから生成されるため、古くなることはありません。

このリポジトリのスキル

すぐに使える Python で、Python 標準ライブラリのみを使用します。すべてをインストールすることも、必要なものだけをインストールすることもできます。

スキル	ツール	目的
edgrapi-full	9	以下のすべてを、5 つのソースにわたって 1 つのスキルに集約
edgrapi-gov	5	SAM.gov の契約機会、USAspending の受賞情報、Grants.gov、議会議員の取引
edgrapi-fundamentals	2	正規化された財務諸表と計算済みの比率
edgrapi-filings	2	企業プロフィールと直近の 10-K/10-Q/8-K

認証

EDGRAPI_KEY にキー（形式は edgr_...）を設定します。キーは X-API-Key ヘッダーとして送信され、ベース URL はハードコードされているため、キーが他のホストに送られることはありません。

export EDGRAPI_KEY="edgr_..."

無料キーを取得 — 最初に 50 クレジットが付与されます。カードは不要です。同じキーをスキル、MCP サーバー、直接の REST 呼び出しに使用できます。

料金

クレジットはリクエストごとに一律で消費されるのではなく、エンドポイントごとに消費量が異なります。政府関連のエンドポイントは 2 クレジットです。SEC 関連では、企業情報、提出書類、イベント、エンティティ解決、全文検索は 1 クレジット、ファンダメンタルズ、比率、XBRL は 3 クレジット、セクション、インサイダー、保有状況、アクティビスト関連は 5 クレジットです。呼び出しの正確なコストは X-Credits-Cost ヘッダーで返されます。

プラン	価格	クレジット
Free	$0	初回 50（1 回限り）
Starter	$10/mo	月 10,000
Pro	$29/mo	月 30,000
Pro annual	$290/yr	前払いで 360,000
Business	$99/mo	月 150,000

追加パックは 1 回限りの購入で、有効期限はありません：5,000 / $7 · 15,000 / $18 · 50,000 / $55。有料プランのクレジットは翌月に繰り越されます。詳細は https://edgrapi.com/pricing をご覧ください。RapidAPI では従量課金も利用できます。

制限事項

• 議会議員の取引情報は米国下院のみで、金額は範囲で示され、法律により最大 45 日遅れて報告されます。
• **州・地方自治体（SLED）の調達情報はありません。**連邦政府のみです。
• **契約アラートは毎日ポーリングされ、リアルタイムではありません。**そのため、通知が届く時点で最大 1 日前の情報である場合があります。
• **データの更新頻度は各ソースによって異なります。**Edgrapi は公式フィードを正規化しますが、データを保持したり、内容を書き換えて再公開したりすることはありません。
• USAspending の検索対象は 2007-10-01 以降で、EDGAR の全文検索は 2001 年以降を対象としています。

ソース

• ドキュメント：https://edgrapi.com/docs · OpenAPI 3.1：https://edgrapi.com/openapi.json
• エージェントガイド：https://edgrapi.com/agents · ステータス：https://edgrapi.com/status

問題の報告と貢献

CONTRIBUTING.md をご覧ください。セキュリティに関する報告：SECURITY.md。

ライセンス

MIT No Attribution。フォーク、公開、サブライセンスが可能で、帰属表示は不要です。

独立性

Edgrapi は独立したサービスであり、米国証券取引委員会、一般調達局、SAM.gov、USAspending.gov、Grants.gov、または米国下院と提携、推奨、後援関係にありません。すべてのデータはこれらの機関の公開システムに由来し、パブリックドメインに属します。