Edgrapi — US Government Data API

edgrapi-skills

为 AI Agent 提供美国政府数据——五个官方来源，一个密钥，一套 JSON 架构。

SAM.gov 合同机会、USAspending 奖项、Grants.gov 资助、美国众议院《STOCK 法案》交易记录， 以及 SEC EDGAR 文件，通过托管 MCP 服务和可直接使用的 Python 技能提供，并基于 Edgrapi API。

这些数据源都免费且公开，但各自也有令人头疼的问题：SAM.gov 使用的是你以为应该是 naics 的 ncode，并会静默忽略未知筛选条件；日期格式为 MM/dd/yyyy，查询时间范围最长为一年； USAspending 的 hasNext 会在记录数达到 10,000 时变为 false，但实际仍有记录，最多可达 50,000； EDGAR 则存在 XBRL 标签变动。Edgrapi 将所有数据统一为一套架构，让你的 Agent 一次调用即可获得可信数据。

免费开始——获取密钥，起始赠送 50 个免费额度，无需银行卡。

纯 Python 标准库，无依赖。采用 MIT-0 许可。

最快上手：托管 MCP 服务

无需安装，也无需本地进程。将任意 MCP 客户端指向一个 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

也已列入官方 MCP 注册表，名称为 io.github.paperandbeyond23-gif/edgrapi-skills。

MCP 服务涵盖的内容

19 个工具，全部为只读。

来源	工具	额度
SAM.gov	get_opportunities — 按 NAICS、保留类别、州、类型查询合同机会	2
USAspending	get_awards — 合同、资助、贷款、直接付款	2
Grants.gov	get_grants — 包含 CFDA 编号和截止日期的资助机会	2
国会	get_congress — 美国众议院《STOCK 法案》股票交易记录	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 代码，纯标准库。可安装全部技能，也可只安装所需技能。

技能	工具	用途
edgrapi-full	9	将以下所有内容整合到一个技能中，涵盖全部五个来源
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 标头返回。

计划	价格	积分
免费版	$0	初始 50（一次性）
Starter	$10/mo	10,000 / 月
Pro	$29/mo	30,000 / 月
Pro 年付	$290/yr	一次性到账 360,000
Business	$99/mo	150,000 / 月

可一次性购买加购积分包，永不过期：5,000 / $7 · 15,000 / $18 · 50,000 / $55。付费计划的积分可结转。完整详情请访问 https://edgrapi.com/pricing。也可通过 RapidAPI 按量计费。

明确说明的限制

• 国会议员交易数据仅涵盖美国众议院，以美元区间报告，并依法最多延迟 45 天。
• **不提供州或地方（SLED）采购数据。**仅限联邦数据。
• 合同提醒每天轮询一次，而非实时更新，因此通知抵达时可能已经过时一天。
• **各数据源按自身的更新频率更新。**Edgrapi 会对官方数据源进行规范化处理；不会持有或重新发布任何数据。
• USAspending 搜索无法查询 2007-10-01 之前的数据；EDGAR 全文搜索涵盖 2001 年以来的数据。

来源

• 文档：https://edgrapi.com/docs · OpenAPI 3.1：https://edgrapi.com/openapi.json
• Agent 指南：https://edgrapi.com/agents · 状态：https://edgrapi.com/status

问题与贡献

请参阅 CONTRIBUTING.md。安全问题报告请参阅 SECURITY.md。

许可证

MIT No Attribution。可自由分叉、发布和再许可，无需注明出处。

独立性

Edgrapi 是一项独立服务，与美国证券交易委员会、总务管理局、SAM.gov、USAspending.gov、Grants.gov 或美国众议院无关联，也未获其认可或赞助。所有数据均源自这些机构的公共系统，并属于公有领域。