Edgrapi Government Data

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install edgrapi-gov
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 edgrapi-gov。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Edgrapi Government Data 给 OpenClaw 提供访问 5 个工具的能力，用于调研联邦合同机会、获奖历史、资助资金和美国众议院议员的股票交易。它对来自 SAM.gov、USAspending 和 Grants.gov 的记录进行了标准化，有助于避免特定数据源的特殊问题（例如不一致的日期格式、筛选行为和分页限制）。
当用户明确要求获取联邦数据并需要有源可查的记录而非估计值时，可以使用此 Skill。在用于公共数据调研的 Openclaw Skills 中，它减少了分别对接多个政府 API 的需求。数据覆盖仅限联邦层面；国会交易披露仅限美国众议院，且可能比实际交易滞后长达 45 天。

应用场景

按 NAICS 代码、州、预留计划（set-aside）、标题或发布日期查找公开的联邦合同机会。
调研联邦奖励接收者、机构支出以及历史合同或资助奖励。
按关键词、机构、资格、状态或协助列表（CFDA）编号发现联邦资助机会。
审查已披露的美国众议院议员股票交易，或按特定股票代码（ticker）搜索交易记录。
当需要可靠的筛选和分页功能时，跨数据源比较政府记录。
请勿用于州或地方政府采购、参议院交易披露、附带提及的政府信息或实时警报。

工作原理

确认请求是专门针对联邦机会、奖励、资助或美国众议院交易。
选择匹配的 Edgrapi 工具：get_opportunities、get_awards、get_grants、get_congress 或 get_congress_ticker。
提供相关的筛选器和分页选项。对于机会查询，正常传入 naics；服务会将其转换为 SAM.gov 的 ncode 参数。
Edgrapi 查询适用的公共数据源，并将结果标准化为统一的 JSON schema，处理特定数据源的 API 行为。
展示返回的记录及其相关上下文和限制。明确将众议院交易金额描述为已披露的美元区间而非精确值，并注意披露可能会滞后长达 45 天。
如果请求失败，检查返回的错误和详细信息；适当时重试数据源服务中断，或解决身份验证、点数（credit）或速率限制（rate-limit）问题。

配置指南

从 edgrapi.com/app 获取 Edgrapi API key。免费套餐每月包含 100 个 credit，无需支付卡。
使用通常的 skill 部署流程将该 skill 提供给您的 OpenClaw 环境。SKILL.md 未指定单独的安装命令或本地数据目录。
在调用工具之前设置必需的 EDGRAPI_KEY 环境变量：
export EDGRAPI_KEY="edgr_..."
API key 在 X-API-Key 请求头中发送至 Edgrapi 硬编码的 base URL，不会发送至其他主机。每次工具调用消耗 2 个 credit。付费套餐起价为每月 $10，包含 10,000 个 credit。参见 Edgrapi pricing。
Edgrapi Government Data 数据架构与分类体系
该 skill 未描述本地生成的文件或持久化存储布局。它通过 Edgrapi 查询公共源数据并返回标准化的 JSON 记录，无需分别对接每个政府 API。
Tool Source and record type Main query fields
get_opportunities SAM.gov; open federal contract opportunities Posting dates, NAICS, notice type, state, set-aside, title, limit, offset
get_awards USAspending; federal awards Category, keyword, agency, recipient, state, date range, limit, page, sort, order
get_grants Grants.gov; federal grant opportunities Keyword, status, agency, category, eligibility, ALN/CFDA, limit, offset
get_congress US House disclosures; congressional stock trades Optional buy/sell action and limit
get_congress_ticker US House disclosures; trades in a specific stock Required ticker and limit
错误以包含 error 和 detail 的对象形式返回，而不是作为异常抛出。可识别的情况包括 auth_required、auth_invalid、out_of_credits、rate_limit_exceeded 和 source_unavailable。数据源时效性遵循各官方 Feed 的更新节奏；Edgrapi 对这些 Feed 进行标准化，但不保留或重新表述底层信息。

高级特性

5 个专属工具覆盖采购机会、奖励调研、资助、众议院交易活动以及按股票代码进行的交易搜索。 标准化特定数据源的行为，包括 SAM.gov 的
ncode
映射和日期格式，以及 USAspending 的分页特性。
支持详细的查询筛选器、排序、limit、offset 和页码（如果适用）。
使用单个 API key 和硬编码的 Edgrapi base URL；凭据通过
X-API-Key
请求头发送。
为凭据缺失或无效、点数耗尽、速率限制和上游数据源不可用返回结构化的错误详情。
每次调用消耗 2 个 credit；免费每月套餐会更新 100 个 credit。
尊重数据覆盖边界：仅限联邦数据、仅限美国众议院交易，无实时通知流。保存的搜索为每日轮询而非实时流。

name: edgrapi-gov version: 1.0.0
description: US federal procurement, spending, grants and congressional trading via Edgrapi.com. Five tools — open SAM.gov contract opportunities, USAspending awards, Grants.gov funding, and US House STOCK Act stock trades, normalized to one JSON schema so you don't integrate four government APIs. license: MIT-0
author: Edgrapi
homepage: https://edgrapi.com
repository: https://github.com/paperandbeyond23-gif/edgrapi-skills
tags:

• edgrapi
• government-data
• sam-gov
• usaspending
• grants-gov
• govcon
• federal-contracts
• procurement
• stock-act
• api
• mcp