iwencai-mcp 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +31 -8
  2. package/package.json +3 -2
  3. package/skills/iwencai/SKILL.md +76 -0
package/README.md CHANGED
@@ -44,19 +44,42 @@ npx iwencai-mcp
44
44
  claude mcp add iwencai \
45
45
  --env IWENCAI_API_KEY=xxx \
46
46
  --env IWENCAI_BASE_URL=https://openapi.iwencai.com \
47
- -- npx -y tsx /path/to/iwencai-mcp/src/server.ts
47
+ -- npx -y iwencai-mcp
48
48
  ```
49
49
 
50
- ## 发布 (npm)
50
+ > 本地开发 / 未发布改动时,可改用 `npx -y tsx /path/to/iwencai-mcp/src/server.ts`。
51
51
 
52
- CI 在推送 `v*` 标签或手动触发时发布:
52
+ ## Skill (`iwencai`)
53
53
 
54
- ```bash
55
- git tag v0.2.0
56
- git push origin v0.2.0
57
- ```
54
+ 仓库附带一个 **`iwencai` 技能**,把 Claude Code 与上面的 MCP 串起来:它不直接调 API,而是**指引调用 `iwencai` MCP 的 25 个工具**,负责意图识别、问句改写、结果解析与来源标注。技能就是一个独立文件 `skills/iwencai/SKILL.md`,安装时把它软链(或复制)到 `~/.claude/skills/iwencai/`:
58
55
 
59
- 需要先在 GitHub 仓库设置 secret `NPM_TOKEN`(npm 访问令牌)。
56
+ ### 意图 → 工具映射
57
+
58
+ | 用户问什么 | 工具 |
59
+ |---|---|
60
+ | 股票/ETF/指数 价格、涨跌幅、成交量、主力资金、技术指标 | `query_market_data` |
61
+ | 行业估值、财务、盈利、板块排名 | `query_industry_data` |
62
+ | 个股营收、净利润、ROE、负债率、现金流 | `query_finance_data` |
63
+ | GDP、CPI、PPI、利率、汇率、社融、M2 | `query_macro_data` |
64
+ | 指数行情(上证/沪深300/创业板/恒生/纳指) | `query_index_data` |
65
+ | 基金业绩、持仓、风险、评级、基金经理 | `query_fund_data` |
66
+ | 期货期权行情、波动率、产销、会员持仓、行权 | `query_futures_data` |
67
+ | 研报评级、业绩预测、ESG、信用评级、券商金股 | `query_insresearch_data` |
68
+ | 业绩预告、增发、质押、解禁、调研、监管函 | `query_event_data` |
69
+ | 主营业务、主要客户/供应商、参控股公司、重大合同 | `query_business_data` |
70
+ | 股本结构、股东户数、前十大股东、实控人 | `query_management_data` |
71
+ | 全品类标的基础信息、发行主体、上市地/日期 | `query_basicinfo_data` |
72
+ | 按条件筛选 A股 / ETF / 可转债 / 基金 / 基金公司 / 基金经理 / 期货期权 / 板块 / 港股 / 美股 | `select_astock` · `select_etf` · `select_cb` · `select_fund` · `select_fundcompany` · `select_fundmanager` · `select_futures` · `select_sector` · `select_hkstock` · `select_usstock` |
73
+ | 财经新闻 / 公司公告 / 券商研报 | `search_news` · `search_announcements` · `search_reports` |
74
+
75
+ ### 使用流程
76
+
77
+ 1. **识别意图** → 查上表选工具。
78
+ 2. **改写问句**为标准金融问句(如 `同花顺今天多少钱` → `同花顺最新价格`)。
79
+ 3. **调用工具**,传 `{query, page?, limit?}`(查询/筛选)或 `{query, size?}`(搜索)。
80
+ 4. **解析结果**:查询/筛选响应含 `datas`/`code_count`,条数多时用 `page` 翻页;搜索响应含 `data`(title/url/summary)。
81
+ 5. **空数据/错误**:放宽条件重试 ≤2 次;网关错误(如额度不足)如实转述;MCP 未配置或缺 key 时引导去 https://www.iwencai.com/skillhub 获取。
82
+ 6. **回答规范**:清晰展示 + 表格解析正确 + **必须注明数据来源于同花顺问财**。
60
83
 
61
84
  ## License
62
85
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "iwencai-mcp",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "问财 (Iwencai) MCP server — 聚合同花顺问财 25 个官方技能(行情/行业/财务/宏观/指数/基金/期货/研报/事件/经营/股东/基本资料 + 选股筛选器 + 新闻/公告/研报搜索)为一个 MCP 服务",
5
5
  "type": "module",
6
6
  "bin": {
@@ -16,7 +16,8 @@
16
16
  },
17
17
  "files": [
18
18
  "dist",
19
- "src"
19
+ "src",
20
+ "skills"
20
21
  ],
21
22
  "keywords": [
22
23
  "mcp",
package/skills/iwencai/SKILL.md ADDED
@@ -0,0 +1,76 @@
1
+ ---
2
+ name: iwencai
3
+ version: 1.0.0
4
+ description: "通过 iwencai MCP 服务查询同花顺问财(问财 SkillHub)金融数据。覆盖股票/ETF/指数/基金/期货期权/港股/美股/可转债行情,行业/财务/宏观指数/基本资料/公司经营/股东股本/机构研究/事件数据,以及选股/选ETF/选基金/选基金公司/选基金经理/选板块/选港股/选美股等筛选器,还有财经新闻、公司公告、券商研报搜索。当用户询问行情、股票价格、涨跌幅、成交量、主力资金、行业、财务、ROE、宏观、指数、基金、选股、新闻、公告、研报等金融数据问题时,必须使用此技能。"
5
+ metadata:
6
+ requires:
7
+ mcp: ["iwencai"]
8
+ cliHelp: "claude mcp get iwencai"
9
+ ---
10
+
11
+ # 问财 金融数据查询
12
+
13
+ ## 概述
14
+
15
+ 本技能**不直接调用 API**,而是指引使用已注册的 **`iwencai` MCP server**(聚合了同花顺问财官方 25 个技能)。数据来源:**同花顺问财** https://www.iwencai.com/unifiedwap/chat
16
+
17
+ 核心流程:**识别意图 → 改写问句 → 调用对应工具 → 解析结果 → 注明数据来源**。
18
+
19
+ ## 工具映射(意图 → MCP 工具)
20
+
21
+ | 用户问什么 | 工具 |
22
+ |---|---|
23
+ | 股票/ETF/指数 价格、涨跌幅、成交量、主力资金、技术指标 | `query_market_data` |
24
+ | 行业估值、财务、盈利、板块排名 | `query_industry_data` |
25
+ | 个股营收、净利润、ROE、负债率、现金流 | `query_finance_data` |
26
+ | GDP、CPI、PPI、利率、汇率、社融、M2 | `query_macro_data` |
27
+ | 指数行情(上证/沪深300/创业板/恒生/纳指) | `query_index_data` |
28
+ | 基金业绩、持仓、风险、评级、基金经理 | `query_fund_data` |
29
+ | 期货期权行情、波动率、产销、会员持仓、行权 | `query_futures_data` |
30
+ | 研报评级、业绩预测、ESG、信用评级、券商金股 | `query_insresearch_data` |
31
+ | 业绩预告、增发、质押、解禁、调研、监管函 | `query_event_data` |
32
+ | 主营业务、主要客户/供应商、参控股公司、重大合同 | `query_business_data` |
33
+ | 股本结构、股东户数、前十大股东、实控人 | `query_management_data` |
34
+ | 全品类标的基础信息、发行主体、上市地/日期 | `query_basicinfo_data` |
35
+ | 按条件筛选 A股 | `select_astock` |
36
+ | 按条件筛选 ETF | `select_etf` |
37
+ | 按条件筛选 可转债 | `select_cb` |
38
+ | 按条件筛选 公募基金 | `select_fund` |
39
+ | 按条件筛选 基金公司 | `select_fundcompany` |
40
+ | 按条件筛选 基金经理 | `select_fundmanager` |
41
+ | 按条件筛选 期货期权 | `select_futures` |
42
+ | 按条件筛选 板块 | `select_sector` |
43
+ | 按条件筛选 港股 | `select_hkstock` |
44
+ | 按条件筛选 美股 | `select_usstock` |
45
+ | 财经新闻/资讯 | `search_news` |
46
+ | 公司公告(财报/分红/回购/重组) | `search_announcements` |
47
+ | 券商研报 | `search_reports` |
48
+
49
+ ## 流程
50
+
51
+ ### 步骤 1 识别意图
52
+ 判断用户问的是行情 / 财务 / 选股 / 资讯 / 公告 / 研报等哪一类,查上表选工具。
53
+
54
+ ### 步骤 2 改写问句
55
+ 把口语问句改写为标准金融问句,保持原意:
56
+ - `同花顺今天多少钱` → `同花顺最新价格`
57
+ - `主力资金流向怎么样` → `主力资金流向`
58
+ - `MACD金叉的股票` → `MACD金叉`
59
+ - `银行业盈利怎么样` → `银行业盈利数据`
60
+
61
+ ### 步骤 3 调用工具
62
+ 向 iwencai MCP 传 `{query, page?, limit?}`(查询/筛选类)或 `{query, size?}`(搜索类)。query 用改写后的问句。
63
+
64
+ ### 步骤 4 解析结果
65
+ - **查询/筛选**(`query2data`):响应含 `datas`(数组)、`code_count`(总条数)、`chunks_info`。若 `code_count > len(datas)`,用 `page` 翻页。
66
+ - **搜索**(`comprehensive/search`):响应含 `data`(数组,含 title/url/summary/publish_date)。
67
+
68
+ ### 步骤 5 空数据 / 错误
69
+ - 若 `datas`/`data` 为空或无数据:放宽或简化条件重试,**最多 2 次**,并说明最终使用的问句。
70
+ - 若返回 `success:false` 或网关错误(如额度不足):把原始错误如实转述,不擅自改写。
71
+ - 若 MCP 未配置或 `IWENCAI_API_KEY` 缺失:提示用户去 https://www.iwencai.com/skillhub 获取并配置。
72
+
73
+ ## 回答规范
74
+ - 结果清晰,表格数据正确解析为表格展示。
75
+ - **必须注明数据来源于同花顺问财**。
76
+ - 若改写了问句,要说明最终使用的查询问句。