SuperAPI AI 工具集

futu-comment-sentiment

数据与分析

查看项目

更新于 11-06 06:47

技能介绍

用途

富途评论情绪技能用于判断富途平台上股票社区讨论的看涨(Bullish)或看跌(Bearish)情绪。它适用于用户提出“查看NVDA社区情绪”“特斯拉最近社区情绪是看涨还是看跌”“分析这组股票的社区情绪”“为我的美股科技组合生成社区情绪摘要”等请求。技能定位为社区讨论基调分析,不涉及基本面估值、官方文件或价格预测,不适用于仅需官方公告、纯新闻汇总、财务建议、目标价或交易执行等场景。

主要能力

  • 支持单只股票或多只股票(组合)的情绪分析。
  • 从富途社区接口获取每只股票近期讨论帖子,保留时间倒序,并对单只股票失败情况继续处理其他股票。
  • 对帖子进行文本清洗(去除HTML标签、合并标题与描述)、时间戳转换(Unix秒级,UTC+8格式化为YYYY-MM-DD HH:mm)。
  • 执行低质量内容过滤:去除垃圾、灌水、重复口号、模板化帖子、低互动内容(若上游提供互动信号)等。
  • 将每条保留帖子分类为看涨、看跌或中性,并聚合计算每只股票及组合的看涨/看跌/中性百分比和帖子数量。
  • 提取前3条代表性观点,优先具体观点、催化剂、担忧、估值看法等,避免泛泛而谈。
  • 多股票模式下先完成逐股情绪计算,再合并所有有效帖子计算组合整体情绪,识别主要驱动股票,并输出逐股分解。
  • 支持将结果输出为规范化JSON对象,便于下游调用方解析。

使用方式

技能通过HTTP接口获取数据,基础URL为 https://ai-news-search.futunn.com。典型请求示例如下:

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'

输入参数包括:symbol_list(必填,一个或多个股票代码、公司名或可识别别名);group_name(可选,组合显示名称);lang(可选,语言提示,如zh-CN、zh-HK、en);size_per_symbol(可选,每只股票获取数量,默认30,限制1-50)。若无法识别任何股票,需询问用户提供至少一个目标。重复股票去重并保留顺序。

处理流程:解析用户输入,提取股票列表、组合名和语言;逐只股票调用社区数据接口;清洗文本、转换时间、过滤低质量内容;分类并聚合情绪;提取观点;按单只或多只模式组织输出;最终返回结构化结果并附加免责声明。

输出模板包括单股票模板和多股票模板,均包含数据窗口、情绪百分比、保留帖子数、摘要、热门观点和免责声明。若有效观点不足3条,仅展示实际数量;若某股票过滤后数据过少,需明确说明证据有限;正常输出不暴露上游原始ID。英文输出时使用Bullish/Bearish/Neutral/Mixed标签。

适用场景

  • 了解散户讨论情绪。
  • 观察社区共识与分歧。
  • 快速对比多只股票的情绪。
  • 生成结构化的组合情绪快照。

限制

  • 仅分析社区讨论基调,不做基本面估值、官方文件解读或价格预测。
  • 不适用于仅需官方公告、纯新闻汇总、财务建议、目标价或交易执行。
  • 上游接口若返回空数据(data为空或code非0),需提示“暂无相关数据,请稍后再试。”或英文对应提示。
  • 若上游未提供互动字段,仍进行文本质量过滤,不编造互动阈值。
  • 情绪分类基于文本线索,存在不确定性,需在信号中标注。
  • 所有用户可见回答必须包含非投资免责声明。
  • 时间显示格式:观点时间显示为MM-DD HH:mm(如04-01 19:45),若所有观点为当天可省略日期;数据窗口头部使用MM-DD HH:mm,同一天可简写为HH:mm ~ HH:mm。

输出结构

规范化输出包含以下顶层字段:request(有效请求参数)、generated_at(ISO-8601完成时间)、mode(single或multi)、group(多股票时的整体情绪,含label、bull_pct、bear_pct、neutral_pct、post_count、summary)、symbols(逐股票结果数组,含symbol、status、upstream_code、upstream_message、label、bull_pct、bear_pct、neutral_pct、post_count、time_range、summary、top_opinions、signals)、top_opinions(前3条整体观点)、disclaimer(固定免责声明)。Opinion对象包含text和published_at。

若只有一只股票,不显示组合级字段。若看涨与看跌比例均不低于25%且差值小于15%,组合标签可为mixed。