MCP & API 服务

面向 AI 智能体与研究工作流的中国上市公司致股东信接口

套餐与定价

功能 / 服务 基础版 高级版
价格¥19 / 月¥99 / 月
每月 API / MCP 调用1,00010,000
REST API 访问
MCP Server 访问
完整致股东信
Markdown 正文返回
公司列表查询
年度信件列表查询
单封信件获取
BM25 全文检索

购买访问权限或申请 API Key,请通过邮件联系。

REST API

Base URL:

https://cn-filings.chenjingluote.workers.dev

REST API 提供公司列表、年度致股东信、Markdown 正文与全文检索能力。

接口说明
GET /服务索引
GET /companies列出全部公司
GET /companies/{slug}获取单家公司信息
GET /companies/{slug}/letters列出某公司可用的致股东信
GET /letters/{slug}/{year}获取某公司某年完整致股东信(含 Markdown 正文)
GET /search?q=&company=&year_from=&year_to=&limit=20检索致股东信,可按公司、年份与数量过滤

搜索模式

搜索使用分层 BM25 流水线,响应中包含 mode 与可读的 note 字段。

模式触发条件匹配逻辑
fts-phrase查询长度 ≥ 3 且存在完整短语匹配完整短语命中,BM25 排序,精度最高
fts-and无短语命中,但所有 3 字窗口均匹配多片段 AND 匹配,BM25 排序
fts-or无 AND 命中,但至少一个 3 字窗口匹配多片段 OR 匹配,召回更高
like查询长度 < 3LIKE 兜底,按年份倒序

MCP Server

MCP 端点:

POST https://cn-filings.chenjingluote.workers.dev/mcp

传输方式:Streamable HTTP,无状态。

可作为远程 MCP Server 接入 Claude Desktop、Claude Code、Cursor 等兼容客户端。

MCP 工具

工具参数说明
list_companies列出全部公司
list_letters{ company }列出某公司可用的致股东信
get_letter{ company, year }获取某公司某年完整致股东信
search_letters{ q, company?, year_from?, year_to?, limit? }检索致股东信,返回结构与 /search 相同

MCP 资源

每封致股东信都暴露为一个 MCP Resource:

letter://{company-slug}/{year}

资源 MIME 类型:text/markdown

能力说明
resources/list列出全部可用的信件资源
resources/read读取选定信件的 Markdown 正文
resources/templates/list返回资源 URI 模板