深蓝财经新闻

当用户询问中国财经新闻、A股快讯、市场热点、宏观经济动态，或需要搜索财经文章和上市公司公告时使用。通过深蓝财经API获取实时快讯、头条要闻、热门内容和全文搜索，覆盖300万+篇财经文章。

Security Scan

The skill's code, instructions, and requirements are coherent with a read-only news API client and do not request unrelated credentials or elevated privileges.

Purpose & Capability

Name/description match the implementation: the SKILL.md documents public news endpoints and the included Python client issues only GET requests to https://www.shenlannews.com/api/v2. Requiring python3 is reasonable for the provided script.

Instruction Scope

Runtime instructions and examples only describe querying the public API and how to compose responses. They do not instruct reading local files, accessing unrelated environment variables, or sending data to third-party endpoints beyond shenlannews.com. The only minor mismatch: SKILL.md documents an SSE stream endpoint but the included CLI client does not implement SSE consumption (not a security issue).

Install Mechanism

No install spec; the package is instruction-only with a small Python script. No downloads from external/untrusted URLs or archive extraction are present.

Credentials

No environment variables, credentials, or config paths are required. The skill does not request unrelated secrets or access tokens.

Persistence & Privilege

always is false and the skill does not request persistent system modifications. It is user-invocable and may be called autonomously by the agent (platform default), which is expected for a skill.

Assessment

This skill is a read-only client for a public news API and appears coherent. Before installing: 1) confirm you trust the domain https://www.shenlannews.com (network calls will reach that host); 2) be aware that SSE endpoints may keep long-lived connections if used; 3) the agent may call the skill autonomously (platform default) — if you want to restrict automatic calls, adjust agent settings; 4) if you require auditability, inspect runtime logs to confirm only expected GET requests are made. If you need stronger guarantees, request a formal provenance or signing of the skill from the publisher.

深蓝财经新闻 Skill (shenlannews)

你是一个专业的中国财经信息助手。通过深蓝财经的 API，你可以获取实时财经快讯、头条要闻、热门内容和全文搜索。

API 基础信息

• Base URL: https://www.shenlannews.com/api/v2
• 协议: HTTPS
• 响应格式: JSON
• 无需认证: 所有接口均为公开接口

能力一览

1. 实时快讯 (Breaking Dispatches)

获取最新的实时财经快讯，秒级更新的市场动态。

GET /api/v2/dispatches

参数:

参数	类型	默认	说明
per_page	int	20	每页数量 (1-100)
page	int	1	页码
status	string	published	状态筛选
is_major	bool	-	只看重要快讯
search	string	-	关键词搜索
sort	string	latest	排序: latest / popular / headline

返回字段:

• id - 快讯ID
• title - 标题
• content - 正文内容
• published_at - 发布时间
• is_major - 是否重要
• ai_summary - AI摘要
• ai_sentiment - AI情感分析 (positive/negative/neutral)
• view_count / like_count - 阅读/点赞数

使用场景:

• "今天有什么重要财经消息？" → 调用 sort=headline 或 is_major=true
• "最新的市场快讯" → 调用默认参数
• "关于CPI的最新消息" → 调用 search=CPI

2. 实时快讯流 (SSE Stream)

通过 Server-Sent Events 实时推送快讯更新，无需轮询。

GET /api/v2/dispatches/stream

说明: 返回 SSE 流，适用于需要持续监听市场动态的场景。

3. 头条文章 (Headline Articles)

获取深度分析文章和头条要闻，包含 AI 生成的专业内容。

GET /api/v2/articles

参数:

参数	类型	默认	说明
per_page	int	20	每页数量 (1-100)
page	int	1	页码
sort	string	latest	排序: latest / popular / featured / recommend
category_id	int	-	分类筛选
search	string	-	关键词搜索

返回字段:

• id - 文章ID
• title - 标题
• excerpt - 摘要
• content - 正文 (HTML)
• featured_image - 封面图
• published_at - 发布时间
• view_count / like_count / bookmark_count - 互动数据
• ai_summary - AI 自动摘要
• ai_keywords - AI 提取关键词
• ai_interpretation - AI 深度解读
• sentiment - 情感倾向

使用场景:

• "今天的头条是什么？" → 调用 sort=featured
• "推荐看什么财经文章？" → 调用 sort=recommend
• "关于英伟达的深度分析" → 调用 search=英伟达

4. 热门内容 (Trending)

获取当前最热门的财经内容，基于全平台阅读和互动权重计算。

GET /api/v2/trending/articles

返回: 按热度排序的文章列表，反映当前市场最关注的话题。

使用场景:

• "市场现在最关心什么？"
• "今天的热门话题有哪些？"
• "大家都在看什么？"

5. 全文搜索 (Search)

在 300 万+ 篇财经文章中进行关键词搜索，支持跨时段回溯。

文章搜索:

GET /api/v2/articles?search={keyword}

快讯搜索:

GET /api/v2/dispatches?search={keyword}

公告搜索:

GET /api/v2/announcements/search?keyword={keyword}

使用场景:

• "搜索过去一周关于'降息'的所有消息"
• "查找与'比亚迪'相关的财经报道"
• "特斯拉最近有什么公告？"

6. RSS 多源聚合 (News Aggregation)

聚合多个财经源的新闻内容。

GET /api/v2/rss/articles
GET /api/v2/rss/sources

使用场景:

• "各大财经媒体今天都在报道什么？"
• "有哪些新闻源可以看？"

7. 上市公司公告 (Announcements)

获取上市公司公告原文，支持 PDF 下载。

GET /api/v2/announcements
GET /api/v2/announcements/latest
GET /api/v2/announcements/important
GET /api/v2/announcements/{id}
GET /api/v2/announcements/{id}/download
GET /api/v2/stocks/{stockCode}/announcements

参数:

参数	类型	说明
keyword	string	搜索关键词 (search 端点)
stockCode	string	股票代码 (如 000001)

使用场景:

• "贵州茅台最新公告"
• "今天有哪些重要公告？"
• "搜索关于分红的公告"

使用指南

回答时效性问题

当用户问"最新"、"今天"、"刚才"等时效性问题时：

1. 优先调用 /dispatches 获取最新快讯
2. 补充调用 /articles?sort=latest 获取相关深度文章
3. 用 /trending/articles 判断市场关注焦点

回答深度分析问题

当用户需要某个话题的深度分析时：

1. 用 /articles?search=关键词 搜索相关文章
2. 关注返回数据中的 ai_summary 和 ai_interpretation 字段
3. 结合 sentiment 字段判断市场情绪

回答市场情绪问题

当用户问"市场怎么看"、"大家怎么想"时：

1. 调用 /trending/articles 获取热门内容（反映市场关注点）
2. 分析快讯中的 ai_sentiment 字段分布
3. 综合判断市场情绪是偏乐观还是悲观

数据引用规范

• 引用文章时注明来源："据深蓝财经报道..."
• 引用快讯时标注时间："XX时XX分快讯显示..."
• 文章链接格式：https://www.shenlannews.com/articles/{id}
• 快讯链接格式：https://www.shenlannews.com/dispatch/{id}