@youhaozhao/cninfo-mcp 1.0.7 → 1.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@youhaozhao/cninfo-mcp)](https://www.npmjs.com/package/@youhaozhao/cninfo-mcp)
 
-通过 MCP 协议查询和下载巨潮资讯网上市公司年报的工具，适用于 Claude Desktop。
+通过 MCP 协议查询和下载巨潮资讯网上市公司年报 PDF 的工具，适用于 Claude Desktop。
 
 ## 使用方法
 
@@ -50,3 +50,4 @@
 
 爬虫逻辑基于 [gaodechen/cninfo_process](https://github.com/gaodechen/cninfo_process)。
 
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youhaozhao/cninfo-mcp",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "MCP Server for querying and downloading Chinese listed companies' annual reports from CNINFO (巨潮资讯网)",
   "keywords": [
     "mcp",
@@ -50,4 +50,4 @@
     "README.md",
     "LICENSE"
   ]
-}
+}

package/python/bridge.py

@@ -0,0 +1,161 @@
+#!/usr/bin/env python3
+"""CLI bridge that exposes cninfo spider functions as JSON in/out for Node.js."""
+
+import json
+import os
+import sys
+import traceback
+from typing import Any, Optional
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from spider import (  # noqa: E402
+    download_annual_reports,
+    download_prospectus,
+    query_annual_reports,
+    query_prospectus,
+    saving_path,
+)
+
+
+BASE_URL = "https://static.cninfo.com.cn/"
+
+
+def _format_reports(reports: list[dict]) -> list[dict]:
+    formatted = []
+    for report in reports:
+        adj = report.get("adjunctUrl", "")
+        formatted.append(
+            {
+                "announcementTitle": report.get("announcementTitle", ""),
+                "announcementTime": report.get("announcementTime", ""),
+                "secCode": report.get("secCode", ""),
+                "secName": report.get("secName", ""),
+                "adjunctUrl": BASE_URL + adj if adj else "",
+            }
+        )
+    return formatted
+
+
+def _require_stock_code(payload: dict) -> str:
+    stock_code = (payload.get("stock_code") or "").strip()
+    if not stock_code:
+        raise ValueError("stock_code is required")
+    return stock_code
+
+
+def _optional_year(payload: dict) -> Optional[int]:
+    year = payload.get("year")
+    if year is None:
+        return None
+    return int(year)
+
+
+def _resolve_save_path(payload: dict) -> str:
+    save_path = payload.get("save_path")
+    return save_path if save_path else saving_path
+
+
+def action_query_annual_reports(payload: dict) -> dict:
+    stock_code = _require_stock_code(payload)
+    year = _optional_year(payload)
+    reports = query_annual_reports(stock_code, year)
+    suffix = f" for year {year}" if year else ""
+    if not reports:
+        return {
+            "success": False,
+            "stock_code": stock_code,
+            "year": year,
+            "count": 0,
+            "reports": [],
+            "message": f"No annual reports found for stock {stock_code}{suffix}",
+        }
+    return {
+        "success": True,
+        "stock_code": stock_code,
+        "year": year,
+        "count": len(reports),
+        "reports": _format_reports(reports),
+        "message": f"Found {len(reports)} annual report(s){suffix}",
+    }
+
+
+def action_download_annual_reports(payload: dict) -> dict:
+    stock_code = _require_stock_code(payload)
+    year = _optional_year(payload)
+    output_dir = _resolve_save_path(payload)
+    os.makedirs(output_dir, exist_ok=True)
+    result = download_annual_reports(stock_code, year, save_path=output_dir)
+    result["stock_code"] = stock_code
+    result["year"] = year
+    return result
+
+
+def action_query_prospectus(payload: dict) -> dict:
+    stock_code = _require_stock_code(payload)
+    reports = query_prospectus(stock_code)
+    if not reports:
+        return {
+            "success": False,
+            "stock_code": stock_code,
+            "count": 0,
+            "reports": [],
+            "message": f"No prospectus found for stock {stock_code}",
+        }
+    return {
+        "success": True,
+        "stock_code": stock_code,
+        "count": len(reports),
+        "reports": _format_reports(reports),
+        "message": f"Found {len(reports)} prospectus document(s)",
+    }
+
+
+def action_download_prospectus(payload: dict) -> dict:
+    stock_code = _require_stock_code(payload)
+    output_dir = _resolve_save_path(payload)
+    os.makedirs(output_dir, exist_ok=True)
+    result = download_prospectus(stock_code, save_path=output_dir)
+    result["stock_code"] = stock_code
+    return result
+
+
+ACTIONS = {
+    "query_annual_reports": action_query_annual_reports,
+    "download_annual_reports": action_download_annual_reports,
+    "query_prospectus": action_query_prospectus,
+    "download_prospectus": action_download_prospectus,
+}
+
+
+def main() -> int:
+    if len(sys.argv) < 3:
+        sys.stderr.write("usage: bridge.py <action> <json-payload>\n")
+        return 2
+
+    action = sys.argv[1]
+    raw_payload = sys.argv[2]
+
+    handler = ACTIONS.get(action)
+    if handler is None:
+        sys.stdout.write(json.dumps({"ok": False, "error": f"Unknown action: {action}"}))
+        return 1
+
+    try:
+        payload = json.loads(raw_payload) if raw_payload else {}
+    except json.JSONDecodeError as exc:
+        sys.stdout.write(json.dumps({"ok": False, "error": f"Invalid JSON payload: {exc}"}))
+        return 1
+
+    try:
+        result: Any = handler(payload)
+        sys.stdout.write(json.dumps({"ok": True, "payload": result}, ensure_ascii=False))
+        return 0
+    except Exception as exc:
+        sys.stderr.write(traceback.format_exc())
+        sys.stdout.write(json.dumps({"ok": False, "error": str(exc)}))
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/python/spider.py

@@ -18,6 +18,13 @@ _saving_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "pdf")
 saving_path = _saving_path + "/"
 logger = logging.getLogger(__name__)
 
+# 巨潮资讯历史公告的实际下限约为 2001 会计年度，再往前查询无数据返回。
+EARLIEST_DATE = "2001-01-01"
+# 接口单页最大返回条数
+PAGE_SIZE = 30
+# 翻页安全上限，防止异常情况下无限循环
+MAX_PAGES = 100
+
 User_Agent = [
     "Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Win64; x64; Trident/5.0; .NET CLR 3.5.30729; .NET CLR 3.0.30729; .NET CLR 2.0.50727; Media Center PC 6.0)",
     "Mozilla/5.0 (compatible; MSIE 8.0; Windows NT 6.0; Trident/4.0; WOW64; Trident/4.0; SLCC2; .NET CLR 2.0.50727; .NET CLR 3.5.30729; .NET CLR 3.0.30729; .NET CLR 1.0.3705; .NET CLR 1.1.4322)",
@@ -55,6 +62,26 @@ def _date_range(start_date: str) -> str:
     return f"{start_date}~{today}"
 
 
+def _paginate(fetch_fn, stock):
+    """
+    对单页查询函数翻页，汇总所有页的公告。
+
+    巨潮接口单页最多返回 PAGE_SIZE 条，放开时间区间后历史年报会跨越多页，
+    必须翻页才能取全。以“返回数量不足一页”作为终止条件，并设安全上限。
+    """
+    all_items = []
+    for page in range(1, MAX_PAGES + 1):
+        items = fetch_fn(page, stock)
+        if not items:
+            break
+        all_items.extend(items)
+        if len(items) < PAGE_SIZE:  # 不足一页说明已到最后一页
+            break
+    else:
+        logger.warning("翻页达到上限 %s，结果可能被截断（%s）", MAX_PAGES, stock)
+    return all_items
+
+
 def _is_annual_report_title(
     title: str, year_filter: Optional[Union[int, str]] = None
 ) -> bool:
@@ -101,7 +128,7 @@ def szseAnnual(page, stock):
     query_path = "http://www.cninfo.com.cn/new/hisAnnouncement/query"
     query = {
         "pageNum": page,  # 页码
-        "pageSize": 30,
+        "pageSize": PAGE_SIZE,
         "tabName": "fulltext",
         "column": "szse",  # 深交所
         "stock": "",
@@ -110,7 +137,7 @@ def szseAnnual(page, stock):
         "plate": "sz",
         "category": "category_ndbg_szsh",  # 年度报告
         "trade": "",
-        "seDate": _date_range("2020-01-01"),  # 时间区间
+        "seDate": _date_range(EARLIEST_DATE),  # 时间区间
     }
 
     namelist = requests.post(
@@ -127,7 +154,7 @@ def sseAnnual(page, stock):
     query_path = "http://www.cninfo.com.cn/new/hisAnnouncement/query"
     query = {
         "pageNum": page,  # 页码
-        "pageSize": 30,
+        "pageSize": PAGE_SIZE,
         "tabName": "fulltext",
         "column": "sse",
         "stock": "",
@@ -136,7 +163,7 @@ def sseAnnual(page, stock):
         "plate": "sh",
         "category": "category_ndbg_szsh",  # 年度报告
         "trade": "",
-        "seDate": _date_range("2020-01-01"),  # 时间区间
+        "seDate": _date_range(EARLIEST_DATE),  # 时间区间
     }
 
     namelist = requests.post(
@@ -153,7 +180,7 @@ def szseStock(page, stock):
     query_path = "http://www.cninfo.com.cn/new/hisAnnouncement/query"
     query = {
         "pageNum": page,  # 页码
-        "pageSize": 30,
+        "pageSize": PAGE_SIZE,
         "tabName": "fulltext",
         "column": "szse",
         "stock": "",
@@ -162,7 +189,7 @@ def szseStock(page, stock):
         "plate": "sz",
         "category": "",
         "trade": "",
-        "seDate": _date_range("2015-01-01"),  # 时间区间
+        "seDate": _date_range(EARLIEST_DATE),  # 时间区间
     }
 
     namelist = requests.post(
@@ -179,7 +206,7 @@ def sseStock(page, stock):
     query_path = "http://www.cninfo.com.cn/new/hisAnnouncement/query"
     query = {
         "pageNum": page,  # 页码
-        "pageSize": 30,
+        "pageSize": PAGE_SIZE,
         "tabName": "fulltext",
         "column": "sse",
         "stock": "",
@@ -188,7 +215,7 @@ def sseStock(page, stock):
         "plate": "sh",
         "category": "",
         "trade": "",
-        "seDate": _date_range("2015-01-01"),  # 时间区间
+        "seDate": _date_range(EARLIEST_DATE),  # 时间区间
     }
 
     namelist = requests.post(
@@ -271,13 +298,13 @@ def query_prospectus(stock_code):
     all_announcements = []
 
     try:
-        announcements_sse = sseStock(1, stock_code)
+        announcements_sse = _paginate(sseStock, stock_code)
         all_announcements.extend(announcements_sse)
     except Exception as e:
         logger.warning("沪市招股书查询失败: %s", e)
 
     try:
-        announcements_szse = szseStock(1, stock_code)
+        announcements_szse = _paginate(szseStock, stock_code)
         all_announcements.extend(announcements_szse)
     except Exception as e:
         logger.warning("深市招股书查询失败: %s", e)
@@ -323,14 +350,14 @@ def query_annual_reports(stock_code, year=None):
 
     # 查询沪市
     try:
-        announcements_sse = sseAnnual(1, stock_code)
+        announcements_sse = _paginate(sseAnnual, stock_code)
         all_announcements.extend(announcements_sse)
     except Exception as e:
         logger.warning("沪市年报查询失败: %s", e)
 
     # 查询深市
     try:
-        announcements_szse = szseAnnual(1, stock_code)
+        announcements_szse = _paginate(szseAnnual, stock_code)
         all_announcements.extend(announcements_szse)
     except Exception as e:
         logger.warning("深市年报查询失败: %s", e)