iFinD × WeStock 超级数据技能

定位：金融数据统一入口，一站式覆盖 A股 / 港股 / 美股 / 基金 / 债券 / 指数 / 宏观 / 新闻公告 / 智能选股选基。

> 本技能整合三个数据源，统一通过 call() 接口暴露：
> - iFinD MCP — 同花顺智能取数（自然语言 query，自然语义理解，支持 8 大服务）
> - westock-data — 腾讯自选股实时/分时/筹码/龙虎榜/ETF/宏观（CLI 命令）
> - westock-tool — 腾讯自选股条件/策略/标签选股（CLI 命令）

路由决策树（见下方详细说明）：

是否需要"选股/选基列表"？
  ├─ YES → westock-tool（filter / strategy / label）
  └─ NO
      ├─ 需要"日内高频实时快照/分时"（盘中）？
      │     ├─ A股/基金/债券/指数 → ifind MCP stock_highfreq_quotes / fund_highfreq_quotes / bond_highfreq_quotes / index_highfreq_quotes
      │     └─ 需要"筹码/龙虎榜/回购/融资融券" → westock-data（CLI）
      ├─ 需要"宏观行业经济指标（GDP/CPI/PMI/工业数据）"？
      │     ├─ 有具体指标名 → ifind MCP edb（get_edb_data）
      │     └─ 不确定指标名 → ifind MCP edb（先 search_edb 再 get_edb_data）
      ├─ 需要"港美股数据"（港股/美股智能选股/财务/行情/事件）？
      │     └─ ifind MCP global_stock
      ├─ 需要"新闻/公告/热点事件"（语义检索）？
      │     └─ ifind MCP news
      ├─ 需要"债券深度数据"（含可转债条款/信用评级/主体财务）？
      │     └─ ifind MCP bond
      ├─ 需要"指数板块行情/成份股"？
      │     ├─ 只需要行情/技术指标 → ifind MCP index（index_data）
      │     ├─ 需要板块区间涨幅排行 → westock-data（sector --rank）
      │     └─ 需要指数/申万板块成份股 → westock-data（index / sector）
      └─ 默认 → ifind MCP stock（智能选股 + 行情/财务/股东/ESG等全量指标）

核心接口

call(server_type, tool_name, params) — iFinD MCP 取数

参数：
- server_type（str）：stock | fund | bond | edb | news | global_stock | index
- tool_name（str）：详见 /references/ 子文档
- params（dict）：不同工具参数不同；核心字段为 query（自然语言描述）

调用方式：优先使用 Node.js（call-node.js），无需任何依赖：

node <skill_dir>/call-node.js <server_type> <tool_name> <params_json>

或 Python 备选（需 requests 库）：

python <skill_dir>/call.py <server_type> <tool_name> <params_json>

query 语法：自然语言描述即可，支持多主体、多指标，主体/指标控制在 5 个以内：

"茅台2025年三季度的ROE"
"苹果和特斯拉近10个交易日的涨跌幅、换手率"
"沪深300、中证2000过去10个交易日的涨跌幅和收盘点数"
"电子行业市值大于100亿的股票"
"锂电池行业股票的今日涨跌幅"

服务类型速查

工具清单速查

stock（A 股）

fund（基金）

bond（债券）

global_stock（港美股）

index（指数板块）

edb（宏观行业经济）

news（新闻公告）

已知限制速查

与 westock-data / westock-tool 的协同分工

> 本技能是 ifind 层的统一入口。westock-data / westock-tool 的 CLI 命令在 AGENTS.md 中有独立路由，
> 以下说明本技能何时应该调用 westock-data / westock-tool：

首次使用配置

1. 配置 iFinD 密钥

配置文件：mcp_config.json，格式：

{
  "auth_token": "your ifind-mcp key"
}

密钥获取路径：MCP官网 → 个人中心 → 密钥

2. 环境验证

• Node.js 方案：无需依赖，直接可用
• Python 方案：需安装 requests 库（pip install requests）
• 推荐优先使用 Node.js 方案

3. 权限确认

免费用户每秒最多并发 2 个请求，个人版 5 个，企业版 10 个。如遇权限错误，先用 listTools(server_type) 确认当前可用工具清单。

调用示例（Node.js）

const { call, listTools } = require('./call-node.js');

async function main() {
    // A股智能选股
    const r1 = await call("stock", "search_stocks", {
        query: "电子行业市值大于100亿的股票"
    });
    console.log(JSON.stringify(r1, null, 2));

    // 港美股财务对比
    const r2 = await call("global_stock", "global_stock_financial", {
        query: "Google和Meta在最新报告期的ROE、ROA、利润增速"
    });
    console.log(JSON.stringify(r2, null, 2));

    // 宏观指标查询
    const r3 = await call("edb", "get_edb_data", {
        query: "光伏电池产量当月值（202301-202506）"
    });
    console.log(JSON.stringify(r3, null, 2));

    // 新闻语义检索
    const r4 = await call("news", "search_news", {
        query: "脑机接口技术最新进展",
        time_start: "2025-01-01",
        time_end: "2026-01-01",
        size: 5
    });
    console.log(JSON.stringify(r4, null, 2));

    // 工具清单查询（备用）
    const tools = await listTools("stock");
    console.log(JSON.stringify(tools, null, 2));
}

main().catch(console.error);

调用示例（Python）

from call import call, list_tools

# A股智能选股
r1 = call("stock", "search_stocks", {"query": "电子行业市值大于100亿的股票"})
print(r1)

# 港美股行情
r2 = call("global_stock", "global_stock_quotes", {
    "query": "苹果和特斯拉近10个交易日的涨跌幅、换手率"
})
print(r2)

# 基金搜索
r3 = call("fund", "search_funds", {"query": "南方基金的新能源ETF"})
print(r3)

# 债券特殊指标（可转债）
r4 = call("bond", "bond_special_data", {
    "query": "华海转债、南航转债的最新转股价格及转换比例"
})
print(r4)

# 宏观指标搜索
r5 = call("edb", "search_edb", {"query": "新能源汽车产量相关指标"})
print(r5)

# 热点事件
r6 = call("news", "search_trending_news", {
    "keyword": "智能体",
    "industry_name": "计算机",
    "time_scope": "24小时",
    "size": 5
})
print(r6)

高频实时行情（结构化参数）

当用户需要日内高频分时或实时行情时，使用结构化参数（不使用 query）：

# A股股票最新实时快照
call("stock", "stock_highfreq_quotes", {
    "symbols": "贵州茅台",
    "indicators": "最新价,涨跌幅,成交量,成交额",
    "data_mode": "real_time"
})

# A股股票1分钟高频行情
call("stock", "stock_highfreq_quotes", {
    "symbols": "300033.SZ,300059,贵州茅台",
    "indicators": "开盘价,最高价,最低价,收盘价,涨跌幅,成交量",
    "data_mode": "highfreq",
    "interval": 1
})

# 指数1分钟高频行情
call("index", "index_highfreq_quotes", {
    "symbols": "创业板指",
    "indicators": "开盘价,最高价,最低价,收盘价,日内累积涨跌幅",
    "data_mode": "highfreq",
    "interval": 1
})

参数说明：
- symbols：逗号分隔，最多 10 个
- indicators：逗号分隔，最多 10 个
- data_mode：必须显式传入 real_time（实时快照）或 highfreq（高频序列），不可省略
- interval：data_mode=highfreq 时有效，支持 1/3/5/10/15/30/60 分钟

参考文档