mcpField
F
futu-comment-sentiment

futu-comment-sentiment

github.com/futunnopen数据与数据库45120 次安装5 天前更新
代码仓库

关于 futu-comment-sentiment

futu-comment-sentiment 是一项分析 Futu 社区股票讨论情绪的技能,适用于单只或多只标的。它过滤低质量帖子,统计看涨、看跌和中性比例,并汇总代表性观点;分析的是社区讨论,而非基本面或价格预测。

主要功能

  1. 01获取一个或多个标的的近期帖子
  2. 02过滤低质量及重复内容
  3. 03分类并统计看涨、看跌和中性情绪
  4. 04生成组合层面及逐标的摘要
  5. 05提取代表性社区观点

适用场景

  1. 01查看单只股票的社区情绪
  2. 02比较多只股票的讨论倾向
  3. 03生成投资组合情绪概览
  4. 04汇总社区中的主要观点

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/futunnopen/futu-agent-hub --skill futu-comment-sentiment

安装后在 Claude Code 中输入/futu-comment-sentiment确认已加载。

详细介绍

富途评论情绪技能

默认使用用户的语言回答。

通过 HTTP 聚合富途平台讨论中单个或多个标的的实时社区情绪。

此技能适用于用户提出以下请求:

  • “查看 NVDA 社区情绪”
  • “最近 Tesla 社区情绪是看涨还是看跌?”
  • “分析这组股票的社区情绪”
  • “为我的美股科技投资组合生成社区情绪摘要”

此技能会检索每个目标标的的近期社区帖子,过滤低质量内容,计算看涨/看跌/中性情绪分布,然后生成:

  1. 仅提供一个目标标的时,输出单个标的的情绪
  2. 提供多个目标标的时,生成投资组合层面的情绪摘要
  3. 整组标的中的热门社区观点
  4. 按标的细分的情绪明细,便于比较

基础 URL: https://ai-news-search.futunn.com


空结果处理

如果 API 返回空结果(data 为空或 code 不为 0),请显示:

  • 中文:“暂无相关数据,请稍后再试。”
  • English:“No data available at the moment. Please try again later.”

定位

此技能侧重于社区讨论的整体倾向,不涉及基本面估值、官方公告或价格预测。

当用户需要以下内容时,应使用此技能:

  • 散户讨论情绪
  • 社区共识与分歧
  • 快速比较各标的的情绪
  • 结构化的投资组合情绪概览

此技能不适用于:

  • 仅查询官方公告
  • 不解读社区观点的纯新闻汇总
  • 财务建议、目标价或交易执行

工作流

1. 解析用户输入

从用户请求中提取以下内容:

  • symbol_list:一个或多个标的代码、公司名称或常见股票简称
  • group_name:可选的投资组合/分组显示名称(如果用户提供),例如 US Tech Portfolio
  • lang:根据用户使用的语言推断,通常为 zh-CN、zh-HK 或 en

解析规则:

  1. 如果无法识别任何标的,请让用户至少提供一个目标标的。
  2. 如果只识别出一个标的,则运行单标的模式。
  3. 如果识别出多个标的,则运行多标的模式。
  4. 忽略用户提供的时间范围,除非上游 API 明确支持,因为此技能定义为实时快照工作流。
2. 调用社区数据 API

针对 symbol_list 中的每个标的,检索与该标的相关的近期讨论/动态帖子。

推荐的检索策略:

  1. 使用富途动态/社区接口,获取近期与股票相关的讨论内容。
  2. 按时间倒序保留结果。
  3. 保留每个标的的上游元数据。
  4. 如果某个标的的上游请求失败,请记录失败信息并继续处理其他标的,不要中止整个批次。
3. 信息处理

针对每个标的,分别执行:

  1. 清理文本:
    • 从标题 / 描述中剥离 HTML 标签
    • 将可见的标题 + 描述合并为一段分析文本
  2. 转换时间戳:
    • 将 publish_time 视为 Unix 纪元值(秒);如果数值看起来是毫秒(> 1e12),则除以 1000
    • 使用 UTC+8(Asia/Shanghai)将时间转换为格式为 YYYY-MM-DD HH:mm 的易读字符串,除非用户的区域设置另有要求
    • 将转换后的字符串作为 published_at 存储在每篇帖子上
    • 处理完某个标的的所有帖子后,根据完整的(筛选前)批次记录 time_range_earliest 和 time_range_latest,以便标题反映实际数据时间范围
  3. 筛除低质量内容:
    • 移除垃圾内容或近乎空白的文本
    • 移除明显的水帖 / 重复的填充短语
    • 降低信息密度极低帖子的权重,或将其排除
    • 如果有互动信号,则降低互动极少内容的权重,或将其排除
  4. 对每篇保留的帖子进行分类:
    • bullish
    • bearish
    • neutral
  5. 汇总每个标的:
    • bull_pct
    • bear_pct
    • neutral_pct
    • post_count
  6. 提取具有代表性的观点:
    • 优先选取具体观点、催化因素、担忧、估值看法和交易解读
    • 避免措辞重复和信息量低的评论
4. 汇总分析

如果只有 1 个标的:

  • 直接输出该标的的情绪分析结果
  • 生成一句话摘要
  • 提取该标的的前 3 条观点

如果有多个标的:

  1. 计算所有标的保留帖子整体的群组情绪。
  2. 生成一句话群组摘要。
  3. 判断群组情绪是由一个还是多个标的驱动。
  4. 然后提供各标的细分结果。
  5. 从合并样本中提取前 3 条群组观点。
5. 组织信息

回复始终应包含:

  1. 包含目标 / 群组名称的标题
  2. 情绪百分比
  3. 保留帖子的总数
  4. 简洁的摘要句
  5. 主要观点
  6. 免责声明
6. 返回结构化结果

返回规范化对象,以便下游调用方可靠地解析结果。

7. 附加免责声明

每条面向用户的回答都必须以非投资建议免责声明结尾。


检索参数

必需的逻辑输入
  • symbol_list:包含一个或多个目标的数组
可选的逻辑输入
  • group_name:可选的投资组合或群组标签
  • lang:可选的语言提示
  • size_per_symbol:上游 API 要求显式指定数量时,每个标的的可选检索数量;默认值为 30,限制在 1-50 之间
验证规则
检查规则
symbol_list 缺失或为空拒绝请求,并要求至少提供一个标的。
去除首尾空白后标的为空移除该标的,并在内部记录。
标的重复去重,同时保留原有顺序。
未提供 size_per_symbol默认值为 30。
size_per_symbol < 1限制为 1。
size_per_symbol > 50限制为 50,除非部署环境允许更高的值。

上游数据契约

此技能假定上游存在类似 stock_feed 的 Futu 讨论区/动态流端点,或社区动态搜索端点,可检索近期与股票相关的帖子。

典型请求格式:

curl -sG 'https://ai-news-search.futunn.com/stock_feed' \
  -H 'User-Agent: futunn-comment-sentiment/0.0.2 (Skill)' \
  --data-urlencode 'keyword=NVDA' \
  --data-urlencode 'size=30'

常见顶层响应:

字段类型描述
codeint320 表示成功
messagestring错误消息或空字符串
dataarray动态/社区条目列表

常见条目字段:

字段类型描述
idstring唯一帖子 ID
titlestring帖子标题
descstring帖子内容或摘要,可能包含 HTML
publish_timestring | int64发布时间戳
urlstring可选的深层链接

如果实际上游端点提供了互动次数、点赞数、评论数或热度分数等额外字段,Agent 应利用这些字段改进低质量内容过滤。


情绪分类规则

在帖子层面仅使用以下三个标签:

  • bullish
  • bearish
  • neutral

必要时,在汇总层面使用以下四个标签:

  • bullish
  • bearish
  • neutral
  • mixed
看涨信号

示例:

  • 预期上涨、反弹、突破或上行
  • 对盈利、产品周期、AI 需求、订单、利润率扩张充满信心
  • 支持性的估值讨论
  • 乐观地逢低买入或长期持有的理由
看跌信号

示例:

  • 预期下跌、回撤、前景疲软或需求疲软
  • 担忧盈利不及预期、竞争、监管、稀释或交付问题
  • 负面的估值观点
  • 恐慌、投降式抛售或强烈避险的语气
中性信号

示例:

  • 不包含方向性观点的事实更新
  • 观望评论
  • 立场混合或模糊
  • 内容可信度较低,且没有明确的方向性倾向
汇总为混合情绪的规则

如果看涨和看跌的占比都较高,且双方都没有明显优势,汇总结果可以使用 mixed。

建议规则:

  • 如果 abs(bull_pct - bear_pct) < 15%
  • 且 bull_pct >= 25% 和 bear_pct >= 25%
  • 汇总标签可以为 mixed

否则:

  • 看涨占比占主导 -> bullish
  • 看跌占比占主导 -> bearish
  • 方向性证据较弱 -> neutral

低质量内容过滤规则

此步骤为必需。不要平等对待检索到的所有帖子。

过滤或降低权重
  • 极短的填充内容,例如只有表情符号、只有“买入”、只有“冲上月球”或反复刷屏股票代码
  • 没有观点的纯转发标记
  • 明显的垃圾信息、广告、引流内容或离题内容
  • 没有增量信息的重复口号式内容
  • 机器生成式模板帖子
  • 上游提供互动信号时,互动极少的帖子
优先保留
  • 明确表达方向性观点的帖子
  • 提供具体理由、催化因素或担忧的帖子
  • 清楚解释市场分歧原因的帖子
  • 互动有意义或具有显著讨论价值的帖子
重要防护要求

如果上游未提供互动字段,仍要执行文本质量过滤。不要捏造基于互动的阈值。


群组级汇总规则

提供多个标的时,严格按以下顺序操作:

  1. 先完成每个标的的过滤和情绪计数
  2. 将所有保留的帖子合并为一个总样本
  3. 计算:
    • group_bull_pct
    • group_bear_pct
    • group_neutral_pct
    • group_post_count
  4. 生成一行 group_summary
  5. 确定哪些标的对当前群组情绪的影响最大
  6. 整体结果之后输出各标的的细分结果
群组摘要风格

良好示例:

  • 整体情绪看涨,乐观情绪主要由 NVDA 带动,而 TSLA 的观点则较为分化。
  • 投资组合整体情绪大致中性偏谨慎,看跌观点集中在需求和估值压力上。
  • 整体分歧显著:AAPL 似乎较为稳定,而 TSLA 和 NVDA 的观点则更加两极化。

避免:

  • 数据不支持的虚假精确性
  • 对未来价格做出强因果断言
  • 投资建议

热门观点提取规则

从保留的帖子中提取排名前 3的观点。

要求:

  1. 使用简短、符合用户表达习惯的观点摘要,最好可直接引用。
  2. 排序前合并重复或近似的观点。
  3. 优先选择以下观点:
    • 在多篇帖子中反复出现
    • 具体且易于理解
    • 能代表当前情绪
  4. 避免使用泛泛而谈的填充内容,例如:
    • “还在关注”
    • “观望一下”
    • “今天波动很大”
  5. 最终热门观点按 published_at 降序排列(最新的在前)。

多标的模式下:

  • 先提取排名前 3 的群组级观点
  • 如有需要,可在摘要中提及起主导作用的标的

面向用户的输出模板

单标的模板
{{symbol}} Community Sentiment · Real Time
Data window: {{time_range_earliest}} ~ {{time_range_latest}}

Community:
Bullish {{bull_pct}}% · Bearish {{bear_pct}}% · Neutral {{neutral_pct}}%
(Based on {{post_count}} retained posts)

Summary:
{{summary}}

Top viewpoints:

1. "{{opinion_1}}" · {{opinion_1_time}}
2. "{{opinion_2}}" · {{opinion_2_time}}
3. "{{opinion_3}}" · {{opinion_3_time}}

This content is based on public information and does not constitute investment advice.

{{platform_source_footer}}
多标的模板
{{group_name}} Community Sentiment · Real Time
Data window: {{time_range_earliest}} ~ {{time_range_latest}}

Overall community:
Bullish {{group_bull_pct}}% · Bearish {{group_bear_pct}}% · Neutral {{group_neutral_pct}}%
(Based on {{group_post_count}} retained posts)

Overall summary:
{{group_summary}}

Per-symbol sentiment:

- {{symbol_1}}: Bullish {{bull_pct_1}}% · Bearish {{bear_pct_1}}% · Neutral {{neutral_pct_1}}%
- {{symbol_2}}: Bullish {{bull_pct_2}}% · Bearish {{bear_pct_2}}% · Neutral {{neutral_pct_2}}%
- {{symbol_3}}: Bullish {{bull_pct_3}}% · Bearish {{bear_pct_3}}% · Neutral {{neutral_pct_3}}%

Top viewpoints:

1. "{{opinion_1}}" · {{opinion_1_time}}
2. "{{opinion_2}}" · {{opinion_2_time}}
3. "{{opinion_3}}" · {{opinion_3_time}}

This content is based on public information and does not constitute investment advice.

{{platform_source_footer}}
显示规则
  1. 如果只提供了一个标的,不要显示群组级包装字段。
  2. 如果有效观点不足 3 条,只显示实际可用的数量。
  3. 如果某个标的经过筛选后有效数据过少,请明确说明证据有限。
  4. 面向普通用户的输出中,绝不显示上游原始 ID。
  5. 英文输出使用 Bullish / Bearish / Neutral / Mixed,而非本地化标签。
  6. 意见的 published_at 时间戳显示格式为 MM-DD HH:mm(例如:04-01 19:45)。如果所有意见的日期相对于 generated_at 都是今天,则省略日期部分。
  7. Data window 标题的起止时间均使用 MM-DD HH:mm。如果最早和最晚时间在同一个日历日,可缩短为 HH:mm ~ HH:mm,并仅显示一次日期。

规范化输出约定

返回一个包含以下顶层字段的结构化对象:

字段类型描述
requestobject生效的请求参数
generated_atstringISO-8601 完成时间戳
modestringsingle 或 multi
groupobject | null当 mode=multi 时的整体投资组合情绪
symbolsarray各标的的情绪结果
top_opinionsOpinion[]面向用户显示的排名前 3 的整体观点
disclaimerstring固定免责声明
Opinion
字段类型描述
textstring观点摘要文本
published_atstring人类可读的时间字符串,YYYY-MM-DD HH:mm(UTC+8)
request
字段类型
symbol_liststring[]
group_namestring | null
langstring | null
size_per_symbolint32
group

仅在 mode=multi 时必需。

字段类型描述
labelstringbullish / bearish / neutral / mixed
bull_pctstring百分比字符串
bear_pctstring百分比字符串
neutral_pctstring百分比字符串
post_countint32保留的群组帖子数量
summarystring一行群组摘要
symbols[]
FieldTypeDescription
symbolstring目标标的
statusstringok / error / empty
upstream_codeint32上游原始状态
upstream_messagestring上游原始消息
labelstringbullish / bearish / neutral / mixed
bull_pctstring百分比字符串
bear_pctstring百分比字符串
neutral_pctstring百分比字符串
post_countint32保留的帖子数量
time_rangeobject{ earliest: string, latest: string },格式为 YYYY-MM-DD HH:mm(UTC+8),根据筛选前的完整批次得出
summarystring对该标的的一句话总结
top_opinionsOpinion[]该标的的热门观点,每条包含 text 和 published_at
signalsobject可选的推理依据
symbols[].signals
FieldTypeDescription
bullish_signalsstring[]重复出现的积极信号
bearish_signalsstring[]重复出现的消极信号
uncertaintiesstring[]证据较弱或存在歧义的内容

最简 JSON 示例

{
  "request": {
    "symbol_list": ["NVDA", "TSLA", "AAPL"],
    "group_name": "US Tech Portfolio",
    "lang": "en",
    "size_per_symbol": 30
  },
  "generated_at": "2026-04-01T10:00:00.000Z",
  "mode": "multi",
  "group": {
    "label": "bullish",
    "bull_pct": "61%",
    "bear_pct": "27%",
    "neutral_pct": "12%",
    "post_count": 842,
    "summary": "Overall sentiment is bullish, with optimism driven mainly by NVDA while TSLA remains more divided."
  },
  "symbols": [
    {
      "symbol": "NVDA",
      "status": "ok",
      "upstream_code": 0,
      "upstream_message": "",
      "label": "bullish",
      "bull_pct": "68%",
      "bear_pct": "22%",
      "neutral_pct": "10%",
      "post_count": 286,
      "time_range": { "earliest": "2026-04-01 17:32", "latest": "2026-04-01 19:57" },
      "summary": "Community sentiment is broadly bullish, with optimism centered on AI demand and earnings continuation.",
      "top_opinions": [
        { "text": "AI demand is still accelerating; this NVDA run may not be over yet.", "published_at": "2026-04-01 19:45" },
        { "text": "The pullback looks more like trading noise and does not break the mid-term thesis.", "published_at": "2026-04-01 18:51" },
        { "text": "Valuation is not cheap, but the fundamentals are still delivering.", "published_at": "2026-04-01 18:03" }
      ],
      "signals": {
        "bullish_signals": ["AI demand", "earnings momentum"],
        "bearish_signals": ["valuation concern"],
        "uncertainties": ["short-term momentum can reverse quickly"]
      }
    },
    {
      "symbol": "TSLA",
      "status": "ok",
      "upstream_code": 0,
      "upstream_message": "",
      "label": "mixed",
      "bull_pct": "49%",
      "bear_pct": "38%",
      "neutral_pct": "13%",
      "post_count": 301,
      "time_range": { "earliest": "2026-04-01 16:10", "latest": "2026-04-01 19:55" },
      "summary": "Bullish and bearish views are clearly split, with optimism coexisting alongside demand concerns.",
      "top_opinions": [
        { "text": "This TSLA move feels more like a sentiment rebound than a solid reset.", "published_at": "2026-04-01 19:30" },
        { "text": "The new narrative is still alive, but delivery pressure has not disappeared.", "published_at": "2026-04-01 18:22" },
        { "text": "If deliveries improve, sentiment could recover quickly.", "published_at": "2026-04-01 17:48" }
      ],
      "signals": {
        "bullish_signals": ["narrative rebound"],
        "bearish_signals": ["delivery pressure", "demand concern"],
        "uncertainties": ["opinion split is large"]
      }
    }
  ],
  "top_opinions": [
    { "text": "AI demand is still accelerating; this NVDA run may not be over yet.", "published_at": "2026-04-01 19:45" },
    { "text": "This TSLA move feels more like a sentiment rebound than a solid reset.", "published_at": "2026-04-01 19:30" },
    { "text": "Apple does not seem to have much incremental upside right now and looks more like a defensive allocation.", "published_at": "2026-04-01 18:10" }
  ],
  "disclaimer": "This content is based on public information and does not constitute investment advice."
}

行为规则

  1. 始终先将请求解析为 symbol_list。不要将投资组合请求简化为单关键词任务。
  2. 始终先过滤低质量内容,再计算百分比。
  3. 结论应基于检索到的讨论文本,而非既有市场知识。
  4. 如果某个标的的上游请求失败,应保留批次结果,并将该标的标记为失败。
  5. 如果某个标的经过筛选后有效帖子过少,应说明证据有限,而不要过度解读。
  6. 在多标的模式下,先输出总体结果,再逐个标的展开分析。
  7. 热门观点应为去重后的总结,而不是照搬垃圾内容。
  8. 切勿提供买卖建议,也不要暗示价格未来必然朝某个方向变动。

身份验证

  • 根据文档中描述的约定,使用公共网关通常无需显式 API 密钥。
  • 如果内部部署后续增加身份验证,请使用环境变量或密钥存储,切勿在此技能中硬编码密钥。

安全

请求与数据
  • 将所有标的视为用户输入,并对其进行 URL 编码。
  • 展示前清除 HTML。
  • 非必要时避免记录大量原始帖子正文。
  • 不要暴露内部网关详情、Cookie 或密钥。
免责声明
  • 社区情绪仅为讨论样本的总结。
  • 情绪不等于未来价格走势。
  • 回复仅供参考,不构成投资建议。

User Agent 请求头

添加 User-Agent 请求头,值为:futu-comment-sentiment/0.0.2 (Skill)

评论

支持 Markdown