爱建证券金融机构数据分析综合工具

概述

爱建证券金融机构数据获取与分析

用途

本 skill 是一套自包含的中国金融机构数据获取与分析工具集，已将底层爬取 / 查询 / 舆情 / 解析等全部脚本（76+ 模块）与机构名单、舆情配置等运行数据一并内置，无需依赖任何外部项目。

覆盖行情、净值、宏观、公告、研报、机构名单、财报解读与全网舆情等金融数据检索场景。

本 skill 只聚焦获取 / 查询，不覆盖反爬调度、语音交互、知识库同步、报告生成导出等工程化能力（相关脚本虽已内置，但默认不暴露为高优能力）。

何时使用

• 用户要查某只股票 / 基金 / ETF / 期货 / 可转债的行情或历史净值
• 用户要查宏观指标（GDP / CPI / PPI / PMI / M2 / Shibor / 回购利率）
• 用户要查港股 / 美股 / 外汇 / 数字货币行情
• 用户要找上市公司公告、券商研报、财报解读
• 用户要查金融机构名单（银行 / 基金 / 券商 / 保险 / 信托等 2300+ 家）
• 用户要监测某机构 / 某股票近 N 天的全网舆情、新闻、利好 / 利空
• 用户要查龙虎榜、北向资金、融资融券、大宗交易、ETF 资金流等市场数据

目录结构

aijian-financial-data-analysis/
├── SKILL.md                 # 本说明
├── mcp_server.py            # 内置 MCP Server（stdio, FastMCP），暴露 79 个工具
├── requirements.txt         # Python 依赖清单
├── scripts/                 # 全部底层模块（76+ .py）
├── data/                    # 机构名单、舆情源、校验规则等运行数据
├── macros/                  # 浏览器自动化宏
├── references/
│   ├── tools.md             # MCP 工具完整清单（按信息类别分组，含参数签名）
│   └── install.md           # 安装与接入指南
└── scripts/fetch.py         # 便捷取数脚本（无需 MCP 客户端）

所有底层模块通过 scripts/ 目录加载，运行数据（data/、macros/）位于 scripts/ 的同级目录，无需任何环境变量或外部路径配置。

两种使用方式

方式 A：作为 MCP Server（推荐，能力最完整）

本 skill 自带 stdio 协议的 MCP Server（mcp_server.py），暴露 79 个工具（行情 / 净值 / 宏观 / 公告 / 研报 / 舆情 / 机构名单 / 财报解读 / 网页爬取等）。

在 MCP 客户端配置中注册（以 CodeBuddy / Claude 风格为例）：

{
  "mcpServers": {
    "aijian-financial-data-analysis": {
      "command": "python",
      "args": ["mcp_server.py"],
      "cwd": "<SKILL_DIR>",
      "env": { "PYTHONPATH": "<SKILL_DIR>/scripts" }
    }
  }
}

注册后可直接调用工具，例如：

• get_financial_data("stock_quote", code="600519") → A 股实时行情
• get_financial_data("fund_nav", code="110011") → 基金净值
• get_financial_data("macro_cpi") → CPI 宏观数据
• search_announcements("贵州茅台") → 公告检索
• query_broker_reports(stock_code="600519") → 券商研报
• interpret_financial_report("600519") → 财报解读
• crawl_global_sentiment(targets="贵州茅台,招商银行", days=7, negative_only=true) → 全网舆情
• query_institution(keyword="华夏基金") → 机构名单

完整工具清单见 references/tools.md。

方式 B：直接调用 Python API（一次性 / 脚本化）

用本 skill 提供的 scripts/fetch.py 包装脚本，无需启动 MCP 客户端即可取数。它会自动把内置的 scripts/ 加入 sys.path 并复用同名底层函数，无需设置任何外部环境变量。

# 直接运行（fetch.py 会自动定位同目录 scripts/ 与 data/）
python scripts/fetch.py quote --code 600519
python scripts/fetch.py fund_nav --code 110011 --days 30

# 宏观
python scripts/fetch.py macro --type macro_cpi
python scripts/fetch.py structured --type shibor

# 公告 / 研报 / 财报解读
python scripts/fetch.py announcements --keyword 贵州茅台
python scripts/fetch.py broker_reports --code 600519
python scripts/fetch.py interpret --code 600519

# 个股技术面 / 估值 / 资金面（新增，详见下方「新增 CLI 子命令」）
python scripts/fetch.py kline --code 600039 --days 250 --tail 10      # 前复权日线
python scripts/fetch.py valuation --code 600039                       # PE/PB/市值快照
python scripts/fetch.py fundflow --code 600039 --days 20              # 主力资金流
python scripts/fetch.py dragon --date 2026-09-30 --limit 20           # 龙虎榜(默认最近交易日)

# 机构名单 / 数据源状态
python scripts/fetch.py institution --keyword 华夏基金
python scripts/fetch.py sources

# 全网舆情
python scripts/fetch.py sentiment --targets "贵州茅台,招商银行" --days 7 --negative-only

fetch.py 在依赖缺失（如未装 akshare）时会优雅返回提示，不会崩溃。

依赖与安装

• 核心（舆情 / 机构查询 / HTTP 爬取）：零 pip 依赖
• 行情 / 宏观结构化数据：pip install akshare
• 动态页面 / 浏览器自动化：pip install playwright && playwright install chromium
• MCP Server 运行：pip install mcp（FastMCP）
• 一键安装全部依赖：pip install -r requirements.txt（在本 skill 目录下执行）

能力分组（获取类）

统一入口优先使用 get_financial_data(query_type, ...)，它内置多源自动降级

（akshare → 东方财富 API → yfinance → RSS），并对结果做标准化与缓存。

新增 CLI 子命令与健壮性约束（v1.1）

运行 scripts/fetch.py 在原有的行情 / 净值 / 宏观 / 公告 / 研报 / 财报解读之外，新增了 4 个个股分析子命令，用于补齐K 线、估值、资金流缺口，并加固市场数据查询的可靠性。

新增子命令

python scripts/fetch.py kline --code 600039 --days 250 --tail 10
python scripts/fetch.py valuation --code 600039
python scripts/fetch.py fundflow --code 600039 --days 20
python scripts/fetch.py dragon --date 2026-09-30 --limit 20

健壮性约束（重要，已修复「静默陈旧数据」缺陷类）

运行本 skill 时发现原代码存在两类「静默返回陈旧数据」的缺陷：① 财报解读 interpret 选错报告期（曾返回一年前的年中报）；② 龙虎榜 stock_lhb_detail_em() 不传日期时默认抓到 2023 年的数据。已将全部约束集中收口到 scripts/constraints.py（只依赖标准库，可被任意脚本安全 import），并在取数 / 解读的关键路径上强制生效（不只是定义）。

集中约束模块 scripts/constraints.py

已强制生效的约束（v1.2）

1. 输入校验（硬拒绝）：fetch.py 的 kline / valuation / fundflow / interpret 以及

stock_market_data 的三个取数函数，进入即 validate_stock_code()，非法代码直接 [FAIL] 退出，不再发无效请求。

1. 自动交易日约束 recent_trade_date() / _auto_trade_date()

所有需要传日期的查询（龙虎榜、两融、大宗交易等）一律自动推断最近交易日（从指数 K 线反推，自动跳过节假日），不再使用 akshare 上游写死的默认日期（如 20230403）。

1. 上游写死默认日期拦截 is_known_stale_default()

龙虎榜 / 两融在 CLI（fetch.py dragon --date 入口 + 返回数据双校验）与 MCP 路由（_q_dragon_tiger / _q_margin_trading）两处拦截，命中即拒绝展示，杜绝"静默返回三年前数据"。

1. 报告期新鲜度守卫 guard_stale_date()（已接入财报解读输出）

report_interpreter.format_text() 在输出报告期后追加陈旧度告警：> 120 天警告、> 400 天标失效、未来日期亦告警。此前的 freshness_flag 只是"定义了没调用"，现已真实生效。

1. 东财域名轮换 + 重试退避 _EM_HOSTS / _http_em()

资金流、行情等东财接口在 push2 / push2his 及其 1. / 2. 前缀域名间轮换，配合 3 次重试与指数退避，降低单域名熔断概率（仍无法完全规避 IP 级限流，见上表 fundflow 警告）。

注意事项与边界

• 实时性：行情类数据来自公开接口，存在分钟级延迟，不等同于交易终端。
• 成功率：天天基金 95%+ / 东方财富 90%+ / 同花顺 85%+ / 基金公司官网 70-90% /

银行官网 30-50%（反爬严格）。

• 不支持：需登录页面（微信公众号后台、券商内网）、付费墙（Wind 终端）、

实时 WebSocket 推送、验证码自动破解。

• 合规：仅用于公开信息的合法获取与聚合分析，遵守目标站点 robots 与频率限制。

参考文档

• references/tools.md — MCP 工具完整清单（按信息类别分组，含参数签名）
• references/install.md — 详细安装、MCP 注册、常用查询示例