FirstData

FirstData 🌐

[English](README.en.md) | 中文 | [日本語](README.ja.md)

---

面向 AI Agent 的外部事实上下文层 — Purpose-built · Authoritative · Structured

The External Facts Context Layer for AI Agents

Agent First：FirstData 以 AI Agent 为第一优先用户设计。Agent 可通过标准化 Skill 自动完成注册、激活和 MCP 配置，零人工介入即可接入权威外部事实上下文。

---

🎯 为什么选择 FirstData?

AI时代的事实防线：从"信息过载"到"真实稀缺"

在生成式 AI 重新塑造互联网的今天，"信息"变得空前充沛，而"真实"正在变得稀缺。

当噪音、拼贴与幻觉成为默认背景，可信的一手证据（Primary Sources）不再只是参考资料，而是整个智能体系的地基。

我们的目标：构建AI时代的可信底座

本项目旨在构建一个面向 AI Agent 的、全球的、权威的、结构化的外部事实上下文层（External Facts Context Layer）。

我们系统性发掘并聚合跨领域高可信信源——覆盖科研学术、政务公开、法律法规、公司披露与财报、标准规范与行业权威资料等——将分散、非标、难复用的原始内容，转化为可追溯、可验证、可引用的"核心事实（Core Facts）"，并保留完整证据链与版本历史，确保每一条结论都能"回到原文"。

这是一道面向大模型时代的"事实防线"

✅ 为模型提供抗幻觉、抗投毒的可信底座

• 计划覆盖1000+权威数据源（来源均为中外政府部门、国际组织、学术机构、行业权威协会）
• 100%的URL验证，确保链接可用

✅ 为 Deep Research 提供可计算、可复查的证据链闭环

• 结构化元数据体系，包含完整访问路径
• 支持编程访问，实现自动化证据追溯

✅ 让 AI 从"模糊概括二手信息"升级为"基于原文证据的严谨推理与引用"

• MCP智能Agent理解复杂查询，精准推荐权威数据源
• 提供直达原始数据的完整路径（URL、API、下载方式）
• 附带使用案例和引用示例，确保正确使用

In the GenAI era, Clean Data > Big Model.

让每一次深度思考，都建立在可以被验证的事实之上。

---

🚀 核心优势

---

📊 数据源概览

覆盖范围

优先收录政府级与国际组织级权威数据源，同步覆盖顶级学术机构与行业权威来源：

数据源列表

📄 浏览已收录的所有数据源：firstdata/sources/README.md

质量标准

每个收录的数据源均满足以下标准：

• ✅ 100% URL验证 — 每个链接都经过测试且可用
• ✅ 权威性优先 — 主要收录政府和国际组织数据源
• ✅ 元数据验证 — 所有JSON文件通过schema验证
• ✅ 双语文档 — 所有数据源提供中英文说明
• ✅ 证据链完整 — 提供从查询到原始数据的完整路径

📐 元数据结构

每个数据源包含 结构化元数据，支持机器可读和自动化证据链构建：

核心信息

• 唯一ID：小写、连字符分隔的标识符
• 名称：英文、中文和本地语言名称
• 组织：名称、类型、国家、官方网站
• 描述：详细的双语描述

访问与发现

• 主要URL：主数据门户
• API信息：可用性、文档、认证要求
• 下载选项：批量下载、支持格式（CSV、Excel、JSON等）
• 访问级别：开放、需注册、学术、商业、受限

覆盖详情

• 地理范围：全球、区域、国家、次国家级
• 国家/地区：具体覆盖区域
• 时间范围：起始年份、结束年份、更新频率
• 领域：经济、健康、气候、能源等
• 数据内容：具体数据类别和内容描述

权威性标识 - AI时代的可信度保障

authority_level字段：权威等级分类

• government - 政府机构
• international - 国际组织
• research - 研究机构
• market - 市场机构
• commercial - 商业机构
• other - 其他

完整Schema: 查看 schemas/datasource-schema.json

🎯FirstData MCP

连接自然语言与一手权威数据的"最后一公里"

---

我们构建了权威数据源的结构化外部事实上下文层，每个数据源都有完整的元数据、访问路径和权威性标识。但对于大多数用户来说，真正的挑战在于：如何在海量数据源中快速找到最合适的那一个？找到了数据源网站，如何在复杂的官方平台中准确定位目标数据？如何将这一切无缝集成到日常的 AI 工作流中？

FirstData MCP 正是为此而生——将静态的外部事实上下文层转化为动态的智能导航系统，让每个人都能轻松访问权威数据。

---

📖 为什么需要FirstData MCP？

在 LLM 时代，我们习惯了直接询问答案，但往往面临两个核心痛点：

❌ 痛点 1：数据来源不可考（幻觉风险）

• AI 生成的数字可能过时、错误或完全虚构
• 缺乏原始证据链，无法追溯验证
• 二手引用层层转述，丢失原始上下文

❌ 痛点 2：专业数据库门槛高（难检索）

• 政府、国际组织网站导航复杂，术语晦涩
• 不知道哪个数据源最权威、覆盖范围如何
• 即使找到官网，也不知道如何定位目标数据

💡 我们的解决方案

本 MCP 服务构建从"模糊意图"到"精确数据路径"的完整闭环：

它不直接生成可能过时的数字，而是作为一位"权威数据向导"，将用户引导至国家统计局、世界银行、行业白皮书等可信一手信源（Primary Sources），并提供具体到点击步骤的检索说明书。

让数据回归权威，让检索不再迷路。

---

✨ 核心功能

1️⃣ 权威信源定位 (Source Locator)

解决"去哪找？"的问题

基于用户的自然语言提问（如："2023年中国新能源汽车出口量"），智能推荐最权威的一手数据源网站。

功能亮点：

• 🧠 理解复杂查询：自动识别地理+时间+领域+权威性等多维度需求
• 🎯 智能推荐：Top 3-5 最相关数据源，附带详细匹配理由
• 📊 权威性保证：所有推荐都标注权威等级（政府/国际组织/研究/市场等）
• 🔗 即用信息：直接提供访问 URL、API 文档、数据格式
• ✅ 证据链完整：从查询到原始数据，每一步都可追溯
• 🌍 全球覆盖：数据源覆盖全球范围内的各大领域，兼顾广度和深度

过滤营销号与二手引用，直达官网、官方报告或专业数据库。

使用示例：

示例1：研究人员 - 发展中国家经济数据 📚

场景：

"我想调研一下发展中国家的GDP信息用于经济增长研究"

传统方式的问题：

• ❌ Google搜索充斥着二手报道、博客文章、过时链接
• ❌ 不确定数据来源的权威性和方法论
• ❌ 花费数小时导航机构网站，仍可能找错数据

使用 FirstData MCP：

1. 🔍 自然语言提问："发展中国家GDP"
2. 🎯 Agent自动筛选：世界银行、IMF、区域开发银行
3. 📊 对比权威等级：国际组织、政府机构等权威性分类

返回结果：

📋 推荐数据源：

1. 世界银行 World Development Indicators

• API：支持（完整文档）
• 覆盖范围：217个国家和地区
• 时间范围：1960年至今
• 权威等级：international（国际组织）
• 证据链：世界银行官方 → 一手数据 → 可追溯

1. IMF World Economic Outlook

• API：支持
• 覆盖范围：全球194个经济体
• 更新频率：季度
• 权威等级：international（国际组织）

价值：

• ✅ 从"不确定的搜索"到"基于权威证据的研究"
• ✅ 节省数小时筛选时间
• ✅ 避免使用错误数据源导致研究结论偏差

示例2：数据分析师 - 中国货币政策数据 💰

场景：

"我需要中国近10年的M1、M2货币供应量和利率数据"

传统方式的问题：

• ❌ AI助手可能给出过时链接或二手网站
• ❌ 不清楚数据更新频率和历史覆盖范围
• ❌ 缺乏API访问信息，无法自动化获取

MCP工作流程：

1. 🔍 识别关键词：中国 + 货币政策 + M1/M2 + 10年时间范围
2. 🎯 筛选条件：国家=CN + 领域=金融 + 时间覆盖≥10年
3. 📊 推荐Top数据源（附带证据链）

返回结果：

📋 推荐数据源：

1. 中国人民银行 (PBC)

• 数据门户：http://www.pbc.gov.cn/diaochatongjisi/
• API文档：有官方接口
• 更新频率：月度
• 历史覆盖：1990年至今
• 权威等级：government（政府机构）
• 证据链：中国央行官方 → 一手数据 → 可追溯

📈 可获取数据：

• M0、M1、M2货币供应量（月度）
• 存贷款基准利率
• 银行间同业拆借利率

价值：

• ✅ 抗幻觉：确保数据来自官方权威机构
• ✅ 可计算：提供API访问，支持自动化数据获取
• ✅ 可复查：完整元数据，任何人都可验证数据来源

示例3：政策制定者 - 全球气候数据 🌍

场景：

"我需要权威的气候数据来支持政策决策，要有API访问的全球数据"

风险：

• ❌ 使用不可靠数据源可能导致政策失误
• ❌ 缺乏方法论透明度，无法评估数据质量
• ❌ 二手引用缺乏原始证据链

MCP工作流程：

1. 🔍 多维度筛选：地理范围=全球 + 领域=气候 + 有API + 高权威性
2. 🎯 推荐符合条件的数据源
3. 📊 按权威等级排序（优先推荐政府和国际组织）
4. 📋 提供完整证据链

返回结果：

📋 推荐数据源：

1. NASA Earthdata

• 覆盖范围：全球
• API：支持（完整文档）
• 数据类型：卫星观测、气候模型
• 权威等级：government（政府机构）
• 更新频率：实时/日度
• 证据链：NASA官方 → 卫星数据 → 可验证

1. NOAA Climate Data Online

• 覆盖范围：全球
• API：支持
• 更新频率：实时/日度
• 权威等级：government（政府机构）
• 证据链：美国政府 → 气象监测 → 可追溯

价值：

• ✅ 证据链闭环：从查询 → 推荐 → 原始数据 → 完整可追溯
• ✅ 方法论透明：明确数据收集方法和质量标准
• ✅ 可复现研究：其他研究者可基于相同数据源验证结论
• ✅ 降低政策风险：从"不确定的决策依据"到"可验证的权威证据"

---

2️⃣ 网站操作导航 (Site Pathfinder)

解决"怎么找？"的问题

针对结构复杂、术语晦涩的专业网站，提供手把手的操作路径说明书，从首页到目标数据的完整导航指引。

功能亮点：

• 📖 逐步操作指引：明确每一步的操作对象、关键界面元素、筛选条件设置
• 🎯 多路径保障：提供主路径 + 备选方案 + API 访问，每条路径都经过验证
• 🔍 精准定位：具体到按钮位置、筛选器设置、下载步骤，而非笼统描述
• 💡 降低门槛：非专业人士也能快速定位，从"数小时摸索"到"3-5分钟精准获取"
• 🔄 定期更新：人工验证网站变化，及时更新操作路径
• 🤖 智能匹配：基于用户查询意图，推荐最相关的操作指令

为常用权威数据源提供详细的网站导航指引，精确定位数据位置。

---

🚀 完整使用示例：智能检索 + 操作说明书一站式方案

场景：查找新上市科技公司招股书进行投资研究

用户提问：

"我想研究国内最近上市的某家AI科技公司，需要找到他们的招股说明书，分析一下商业模式和财务状况"

✅ 使用 FirstData MCP 的完整工作流：

📋 第一步：智能检索可信数据源

推荐数据源：

1. 香港交易及结算所有限公司 (HKEX)

• 描述：港交所运营HKEXnews（披露易），提供上市公司招股书、 年报、IPO信息和监管文件的官方平台
• 访问地址：https://www.hkexnews.hk
• 权威等级：market（市场机构）
• 文档类型：招股说明书、年报、公告
• 证据链：官方披露文件 → 可直接引用

1. 中国证券监督管理委员会 (CSRC)

• 访问地址：http://www.csrc.gov.cn
• 境外上市备案信息查询
• 权威等级：government（政府机构）

价值点：

• ✅ 避免幻觉：推荐的是官方披露平台，不是新闻网站
• ✅ 权威性保证：明确标注数据源的权威等级
• ✅ 提供关键线索：预先提供财务概要信息，帮助理解数据背景

📖 第二步：获取网站操作说明书

MCP 内置了操作说明书数据库，涵盖常用权威数据源的网站导航和下载步骤。

检索披露易（HKEXnews）网站操作指令：

source: https://www.hkexnews.hk

operation: 如何查找新上市公司的招股说明书?

说明书检索结果：

网站操作说明书：

主路径（推荐）：

1. 访问香港交易所披露易网站首页 (https://www.hkexnews.hk)
2. 点击主导航栏中的 "NEW LISTINGS" 选项
3. 进入 New Listing Information 页面
4. 选择对应的市场板块（主板 Main Board 或创业板 GEM）
5. 在新上市公司列表中查找目标公司名称或股票代码
6. 点击对应的招股书下载链接（Prospectus）
7. 下载PDF文件即可

备选路径：

1. 访问香港交易所披露易网站首页
2. 使用搜索功能输入公司名称或股票代码
3. 在搜索结果中筛选文档类型为 "Prospectus"
4. 选择最新日期的招股说明书
5. 点击下载链接获取PDF文件

价值点：

• ✅ 即用指引：提供逐步操作说明，无需人工摸索网站结构
• ✅ 多路径保障：提供备选方案，确保能成功获取文档
• ✅ 降低门槛：非专业人士也能快速定位官方文档

📊 第三步：基于官方数据进行分析

获取招股书后的研究分析框架：

根据招股书披露的官方数据，可以进行系统性分析：

1. 商业模式分析

• 核心业务：从招股书"业务概览"章节了解公司主营业务和收入来源
• 市场定位：分析目标市场、客户群体和竞争优势
• 盈利模式：识别收入结构、定价策略和变现路径

2. 财务状况分析

• 收入趋势：查看历史财务数据，分析营收增长率和可持续性
• 盈利能力：评估毛利率、净利率等关键指标
• 现金流：研究经营活动现金流、融资用途和资金储备

3. 风险因素评估

• 业务风险：招股书"风险因素"章节列出的主要风险
• 财务风险：负债水平、流动性、偿债能力
• 行业风险：市场竞争、技术变革、监管政策变化

4. 投资价值判断

• 成长潜力：基于业务规划和市场前景评估增长空间
• 估值合理性：对比同行业公司市盈率、市销率等指标
• 募资用途：IPO资金使用计划是否与战略目标一致

✅ 完整的证据链闭环：

用户提出研究需求

↓ MCP 智能检索推荐权威数据源（港交所披露易） ↓ 获取网站操作说明书（逐步导航指引） ↓ 下载官方招股说明书（一手权威文档） ↓ 基于官方披露数据进行系统性分析 ↓ 所有结论可回溯至原始文档验证

核心价值：

• ✅ 抗幻觉：推荐的是港交所官方披露平台，而非新闻网站或 AI 生成内容
• ✅ 可验证：完整证据链，任何人都可以沿着路径获取相同的原始数据
• ✅ 即用指引：提供逐步操作说明，从"不知道在哪找"到"3-5分钟精准获取"
• ✅ 多路径保障：主路径 + 备选方案 + 搜索功能，确保能成功下载文档

---

🚀 快速开始

FirstData 提供两条接入路径：AI Agent 自动接入（推荐）和手动配置 MCP。

---

路径一：AI Agent 自动接入（推荐）

如果你正在使用支持 Skill 的 AI Agent（如 Claude Code + OpenClaw 等），可以一键安装 FirstData Skill：

clawhub install firstdata

安装后 Agent 可自动完成注册、激活和 MCP 配置，无需人工操作。

Skill 定义文件：skills/firstdata/SKILL.md ｜ ClawHub 页面：clawhub.ai/ningzimu/firstdata

---

路径二：手动配置 MCP

适用于人工配置场景。支持 Claude Desktop、Cline、Cursor、Zed 等所有兼容 MCP 协议的 AI 应用。

第 1 步：获取 API Key

访问 FirstData API 申请 申请免费的 API Key。

第 2 步：添加 MCP 配置

所有平台的核心配置相同，将以下 JSON 添加到你所用平台的 MCP 配置文件中：

{

"mcpServers": { "firstdata": { "type": "streamable-http", "url": "https://firstdata.deepminer.com.cn/mcp", "headers": { "Authorization": "Bearer " } } } }

注意：Zed 使用 context_servers 而非 mcpServers 作为顶层 key。

第 3 步：找到你的平台配置文件

各平台配置文件位置

| Claude Desktop | macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json | — | | Cline (VS Code) | Cline → 设置 → Advanced MCP settings，或 cline_mcp_settings.json | 文档 | | Cursor | Cmd/Ctrl+Shift+P → "MCP Settings"，或 Cursor Settings → MCP | — | | Copilot / VS Code | VS Code MCP 设置，或 CLI：code --add-mcp '{...}' | [文档](https://code.visualstudio.com/docs/copilot/chat/mcp-serve