MCP Server 文档

通过 MCP (Model Context Protocol) 接口，可在 Claude Desktop 等 AI 客户端中直接查询推文、文章、日报、研究报告等数据。

连接信息

协议SSE (Server-Sent Events)

地址https://tianyan.io:9752/sse

端口9752

认证

MCP Server 需要 API Key 认证。请先在账户设置页面创建 API Key，然后在客户端配置中添加 Authorization header。

支持两种认证方式：

HTTP Header：Authorization: Bearer xc-xxxxxxxxx
URL 参数：?token=xc-xxxxxxxxx

注意：未携带有效 API Key 的请求将返回 401 错误。

Claude Desktop 配置

在 Claude Desktop 配置文件中添加以下内容（Settings > Developer > Edit Config）。请将 your-api-key 替换为你在设置页创建的 API Key：

{
  "mcpServers": {
    "x-crawler": {
      "url": "https://tianyan.io:9752/sse",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

提示：保存后重启 Claude Desktop 即可生效。连接成功后可在对话中直接使用下方工具查询数据。

数据概览

get_data_overview

获取系统数据概览，包括推文、RSS 文章、日报、投资洞察、学习摘要、深度研究报告等各类数据的总量统计。适合在开始使用时调用。

无参数

推文

search_tweets

搜索推文。可按关键词、用户名、日期范围过滤。

参数	类型	必填	默认值	说明
keyword	string	否	""	搜索关键词（在推文内容中模糊匹配）
username	string	否	""	按用户名过滤
start_date	string	否	""	开始日期（YYYY-MM-DD）
end_date	string	否	""	结束日期（YYYY-MM-DD）
limit	int	否	20	返回数量，最大 100

get_recent_tweets

获取最新推文。

参数	类型	必填	默认值	说明
limit	int	否	20	返回数量，最大 100

RSS 文章

search_rss_articles

搜索 RSS 文章，支持按关键词、分类、来源、时间范围过滤。

参数	类型	必填	默认值	说明
keyword	string	否	""	搜索关键词（匹配标题和摘要）
category	string	否	""	按分类过滤（如：科技、AI、金融）
source_name	string	否	""	按来源名称过滤
days	int	否	7	最近几天内的文章
limit	int	否	20	返回数量，最大 100

get_rss_article_content

获取单篇 RSS 文章的完整内容。

参数	类型	必填	默认值	说明
article_id	int	是	-	文章 ID（通过 search_rss_articles 获取）

get_rss_sources

列出 RSS 订阅源，支持按分类过滤。

参数	类型	必填	默认值	说明
category	string	否	""	按分类过滤，为空返回全部
enabled_only	bool	否	true	是否只返回启用的源

get_rss_categories

获取所有 RSS 订阅源的分类列表及每个分类下的源数量。

无参数

报告

get_daily_reports

获取日报列表。系统根据推文自动生成的每日总结。

参数	类型	必填	默认值	说明
topic	string	否	""	按主题过滤
start_date	string	否	""	开始日期（YYYY-MM-DD）
end_date	string	否	""	结束日期（YYYY-MM-DD）
limit	int	否	10	返回数量，最大 50

get_daily_report_content

获取单篇日报的完整内容，包含分类信息。

参数	类型	必填	默认值	说明
report_id	int	是	-	日报 ID（通过 get_daily_reports 获取）

get_investment_insights

获取投资洞察报告，包含市场情绪分析、信号识别等。

参数	类型	必填	默认值	说明
topic	string	否	""	按主题过滤
start_date	string	否	""	开始日期（YYYY-MM-DD）
end_date	string	否	""	结束日期（YYYY-MM-DD）
period	string	否	""	按报告周期过滤（如：daily、weekly）
limit	int	否	10	返回数量，最大 50

get_learning_digests

获取学习摘要。系统从技术推文和文章中提取的学习要点。

参数	类型	必填	默认值	说明
topic	string	否	""	按主题过滤
limit	int	否	10	返回数量，最大 50

get_deep_research_reports

获取深度研究报告列表。系统结合搜索引擎和 AI 生成的深度分析报告。

参数	类型	必填	默认值	说明
research_type	string	否	""	按研究类型过滤（如：market_analysis）
start_date	string	否	""	开始日期（YYYY-MM-DD）
end_date	string	否	""	结束日期（YYYY-MM-DD）
limit	int	否	10	返回数量，最大 30

get_deep_research_report_content

获取单篇深度研究报告的完整内容。

参数	类型	必填	默认值	说明
report_id	int	是	-	报告 ID（通过 get_deep_research_reports 获取）

使用示例

连接 MCP Server 后，可以在 Claude Desktop 中这样提问：

“帮我查看系统里有哪些数据？”→get_data_overview

“搜索最近关于 AI Agent 的推文”→search_tweets

“看看最新的投资洞察报告”→get_investment_insights

“获取本周的深度研究报告”→get_deep_research_reports

X-Crawler MCP Server · 端口 9752