FirstData
What FirstData Is
FirstData is a structured knowledge base of authoritative primary data sources, covering 1000+ sources to help agents locate official origins rather than generating unverified answers.
It does not replace raw data — it acts as an "authoritative data navigator", taking vague user needs as input, recommending the most appropriate primary sources, and providing clear access paths, API information, and download methods so both users and agents can trace back to original evidence.
Coverage:
- - International organizations: World Bank, IMF, OECD, WHO, FAO, etc.
- Chinese government agencies: PBC, National Bureau of Statistics, General Administration of Customs, CSRC, etc.
- National official agencies: US, Canada, Japan, UK, Australia, etc.
- Academic & research databases: NBER, Penn World Table, PubMed, etc.
- Corporate disclosure & market platforms: stock exchange disclosure systems, listed company filings, etc.
- Industry-specific databases: energy, finance, health, climate, legal & regulatory, etc.
When to use: When users need to find official data sources, compare source authority, obtain official URLs/APIs/download paths, or build evidence-chain workflows. FirstData is a source locator, not an answer generator — after receiving results, guide users back to original sources for verification rather than treating them as final answers.
Capabilities
1. Source Locator — Returns the top 3–5 most relevant sources with authority level, matching rationale, access URL, API documentation, and download methods.
2. Site Pathfinder — Provides step-by-step navigation from homepage to target data for complex official websites, including alternative paths and API access methods.
3. Evidence-Ready Workflows — Can be embedded into workflows requiring evidence chains: deep research, policy analysis, investment research, compliance auditing, fact-checking, etc.
Each data source includes structured metadata: authority level (government / international / research / market / commercial / other), access URL, API information, download formats, geographic scope, update frequency, access level, etc.
Typical Queries
Typical query scenarios when agents call FirstData via MCP:
| User Need | Query Direction | Expected Output |
|---|
| "Which official source should I cite for China's 2023 NEV export volume?" | China Customs, National Bureau of Statistics | Official source + authority level + data page URL |
| "Where to download IPO prospectus for a Hong Kong-listed company?" |
HKEXnews | Official platform + step-by-step navigation |
| "World Bank vs IMF GDP data — which is better for academic citation?" | World Bank WDI, IMF WEO | Source comparison + authority differences + API docs |
| "Need global climate data with API access" | NASA Earthdata, NOAA CDO | Data source + API docs + access methods |
| "Where is the official data for China's M2 money supply?" | People's Bank of China | Official data portal + update frequency + historical coverage |
Full project background and feature documentation: README
Quick Start
This skill connects to the FirstData MCP server (firstdata.deepminer.com.cn), the project's official hosted API endpoint. An API key (FIRSTDATA_API_KEY) is required for authentication.
If you already have FIRSTDATA_API_KEY set, configure the MCP connection:
CODEBLOCK0
Or add manually to your MCP config:
CODEBLOCK1
If you don't have an API key, see firstdata-register.md for the registration process (two API calls to the FirstData server to obtain a JWT token).
Once connected, browse the tool list provided by the firstdata MCP and select the appropriate tool based on your needs.
Community
FirstData is an open-source project — join us in building the authoritative data source knowledge base for agents:
- - ⭐ Star the project to help more agents and developers discover it
- 📝 Issue to report problems, suggest new data sources, or propose improvements
- 🔀 PR to contribute code, data sources, or documentation improvements
FirstData
FirstData 是什么
FirstData 是一个结构化的权威一手数据源知识库,覆盖 1000+ 数据源,帮助智能体定位官方数据来源,而非生成未经核实的答案。
它不替代原始数据——而是充当权威数据导航员,以模糊的用户需求为输入,推荐最合适的一手数据源,并提供清晰的访问路径、API 信息和下载方式,使用户和智能体都能追溯到原始证据。
覆盖范围:
- - 国际组织:世界银行、国际货币基金组织、经合组织、世界卫生组织、联合国粮农组织等
- 中国政府机构:中国人民银行、国家统计局、海关总署、中国证监会等
- 各国官方机构:美国、加拿大、日本、英国、澳大利亚等
- 学术与研究数据库:美国国家经济研究局、佩恩世界表、PubMed 等
- 企业披露与市场平台:证券交易所披露系统、上市公司申报文件等
- 行业特定数据库:能源、金融、健康、气候、法律法规等
使用时机:当用户需要查找官方数据源、比较数据源权威性、获取官方网址/API/下载路径,或构建证据链工作流时。FirstData 是数据源定位器,而非答案生成器——收到结果后,应引导用户返回原始来源进行验证,而非将其视为最终答案。
能力
1. 数据源定位器 — 返回最相关的 3-5 个数据源,包含权威等级、匹配理由、访问网址、API 文档和下载方式。
2. 网站导航器 — 针对复杂的官方网站,提供从首页到目标数据的分步导航,包括备选路径和 API 访问方式。
3. 证据就绪工作流 — 可嵌入需要证据链的工作流:深度研究、政策分析、投资研究、合规审计、事实核查等。
每个数据源包含结构化元数据:权威等级(政府 / 国际 / 研究 / 市场 / 商业 / 其他)、访问网址、API 信息、下载格式、地理范围、更新频率、访问级别等。
典型查询
智能体通过 MCP 调用 FirstData 时的典型查询场景:
| 用户需求 | 查询方向 | 预期输出 |
|---|
| 引用中国 2023 年新能源汽车出口量,应该用哪个官方数据源? | 中国海关、国家统计局 | 官方数据源 + 权威等级 + 数据页面网址 |
| 哪里可以下载香港上市公司的招股说明书? |
港交所披露易 | 官方平台 + 分步导航 |
| 世界银行和国际货币基金组织的 GDP 数据,学术引用哪个更好? | 世界银行 WDI、国际货币基金组织 WEO | 数据源对比 + 权威性差异 + API 文档 |
| 需要带 API 访问的全球气候数据 | NASA Earthdata、NOAA CDO | 数据源 + API 文档 + 访问方式 |
| 中国 M2 货币供应量的官方数据在哪里? | 中国人民银行 | 官方数据门户 + 更新频率 + 历史覆盖范围 |
完整项目背景和功能文档:README
快速开始
该技能连接到 FirstData MCP 服务器(firstdata.deepminer.com.cn),即项目的官方托管 API 端点。需要 API 密钥(FIRSTDATAAPIKEY)进行身份验证。
如果你已经设置了 FIRSTDATAAPIKEY,配置 MCP 连接:
bash
npx mcporter config add firstdata https://firstdata.deepminer.com.cn/mcp --header Authorization=Bearer ${FIRSTDATAAPIKEY}
或手动添加到 MCP 配置:
json
{
mcpServers: {
firstdata: {
type: streamable-http,
url: https://firstdata.deepminer.com.cn/mcp,
headers: {
Authorization: Bearer APIKEY>
}
}
}
}
如果你没有 API 密钥,请参阅 firstdata-register.md 了解注册流程(向 FirstData 服务器发起两次 API 调用以获取 JWT 令牌)。
连接后,浏览 firstdata MCP 提供的工具列表,根据需求选择合适的工具。
社区
FirstData 是一个开源项目——加入我们,共同构建面向智能体的权威数据源知识库:
- - ⭐ Star 项目,帮助更多智能体和开发者发现它
- 📝 Issue 报告问题、建议新数据源或提出改进方案
- 🔀 PR 贡献代码、数据源或文档改进