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を入力して読み込まれたか確認します。

詳細

Futu コメントセンチメントスキル

デフォルトでは、ユーザーの言語で回答します。

Futu プラットフォーム上の議論を対象とした、HTTP による単一銘柄または複数銘柄のリアルタイムコミュニティセンチメント集計です。

このスキルは、次のようなユーザーのリクエストを想定しています。

  • 「NVDA のコミュニティセンチメントを確認して」
  • 「最近の Tesla のコミュニティセンチメントは強気ですか、それとも弱気ですか?」
  • 「この銘柄グループのコミュニティセンチメントを分析して」
  • 「米国テクノロジーポートフォリオのコミュニティセンチメントの概要を作成して」

このスキルは、対象銘柄ごとに最近のコミュニティ投稿を取得し、低品質なコンテンツを除外して、強気/弱気/中立の割合を算出したうえで、次の内容を生成します。

  1. 対象が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:1つ以上の銘柄コード、会社名、または一般に認識されている銘柄の別名
  • group_name:ユーザーが指定した場合の、ポートフォリオ/グループの任意の表示名。例:US Tech Portfolio
  • lang:ユーザーの言語から推定します。通常は zh-CN、zh-HK、または en

解析ルール:

  1. 銘柄を特定できない場合は、対象を1つ以上指定するようユーザーに尋ねます。
  2. 銘柄が1つだけ特定された場合は、単一銘柄モードを実行します。
  3. 複数の銘柄が特定された場合は、複数銘柄モードを実行します。
  4. 上流 API が明示的に対応していない限り、ユーザーが指定した期間は無視します。このスキルはリアルタイムのスナップショットを取得するワークフローとして定義されているためです。
2. コミュニティデータ API の呼び出し

symbol_list 内の各銘柄について、その銘柄に関連する最近の議論/フィード投稿を取得します。

優先する取得方法:

  1. 最近の株式関連の議論項目を返す Futu のフィード/コミュニティエンドポイントを使用します。
  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 シンボルの場合:

  • そのシンボルのセンチメント結果を直接出力します。
  • 1 行の要約を作成します。
  • そのシンボルの主な見解を 3 件抽出します。

複数シンボルの場合:

  1. 全シンボルの残した投稿を対象に、グループ全体のセンチメントを計算します。
  2. グループ全体の要約を 1 行で作成します。
  3. グループ全体のセンチメントが 1 つまたは複数のシンボルに左右されているかを特定します。
  4. 次に、シンボルごとの内訳を提示します。
  5. 結合したサンプル全体から、グループ全体の主な見解を 3 件抽出します。
5. 情報を整理する

回答には必ず次の内容を含めます。

  1. 対象/グループ名を含む見出し
  2. センチメントの割合
  3. 残した投稿の合計件数
  4. 簡潔な要約文
  5. 主な見解
  6. 免責事項
6. 構造化された結果を返す

後続の呼び出し元が確実に解析できるよう、正規化されたオブジェクトを返します。

7. 免責事項を追加する

ユーザー向けの回答はすべて、投資に関する免責事項で締めくくる必要があります。


取得パラメーター

必須の論理入力
  • symbol_list:1 つ以上の対象を含む配列
任意の論理入力
  • group_name:任意のポートフォリオ名またはグループ名
  • lang:任意の言語ヒント
  • size_per_symbol:上流 API で明示的な件数が必要な場合の、シンボルごとの任意の取得件数。デフォルトは 30、範囲は 1-50
検証ルール
チェックルール
symbol_list が欠落または空拒否し、シンボルを 1 つ以上指定するよう求めます。
トリミング後のシンボルが空削除し、内部で記録します。
シンボルの重複元の順序を維持して重複を削除します。
size_per_symbol が省略された場合デフォルトを 30 にします。
size_per_symbol < 11 に調整します。
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任意の詳細リンク

実際の上流エンドポイントで、インタラクション数、いいね数、コメント数、注目度スコアなどの追加フィールドが公開されている場合、エージェントはそれらを使って低品質な投稿のフィルタリング精度を高めてください。


センチメント分類ルール

投稿単位では、次の3つのラベルのみを使用します。

  • bullish
  • bearish
  • neutral

必要に応じて、集計単位では次の4つのラベルを使用します。

  • bullish
  • bearish
  • neutral
  • mixed
強気の手がかり

例:

  • 上昇、反発、ブレイクアウト、上値を見込む予想
  • 業績、製品サイクル、AI 需要、受注、利益率の拡大への自信
  • 株価評価を支持する見解
  • 楽観的な押し目買いや長期保有の根拠
弱気の手がかり

例:

  • 下落、調整、弱い見通し、需要の軟化を見込む予想
  • 業績未達、競争、規制、希薄化、納品上の問題への懸念
  • 否定的な株価評価の見解
  • パニック、投げ売り、または強いリスク回避の姿勢
中立の手がかり

例:

  • 方向性に関する意見を伴わない事実の報告
  • 様子見のコメント
  • 混在した、または曖昧な見解
  • 方向性が明確でない、確信度の低い内容
混合の集計ルール

強気と弱気の割合がどちらも無視できず、どちらにも明確な優位性がない場合、集計結果に mixed を使用できます。

推奨ルール:

  • abs(bull_pct - bear_pct) < 15% の場合
  • かつ bull_pct >= 25% および bear_pct >= 25% の場合
  • 集計ラベルに mixed を使用できます

それ以外の場合:

  • 強気の割合が優勢 → bullish
  • 弱気の割合が優勢 → bearish
  • 方向性を示す根拠が弱い → neutral

低品質な投稿のフィルタリングルール

この手順は必須です。取得した投稿をすべて同等に扱わないでください。

除外、または重みを下げる対象
  • 絵文字だけ、「buy」だけ、「to the moon」だけ、ティッカーの繰り返しだけといった、極端に短い埋め草の内容
  • 見解を伴わない、単なる再投稿の表示
  • 明らかなスパム、広告、紹介文、または話題から外れた内容
  • 新たな情報を含まない、スローガンのような反復的な内容
  • 機械的な定型文のような投稿
  • インタラクションのシグナルが利用可能な場合に、インタラクションが極端に少ない投稿
優先的に残す対象
  • 方向性に関する明確な見解を示す投稿
  • 具体的な理由、材料、または懸念を含む投稿
  • 市場の見方が分かれている理由を説明する、明確な異論を含む投稿
  • 有意なインタラクション、または認識できる議論価値のある投稿
重要な注意事項

上流でインタラクションのフィールドが利用できない場合でも、テキストの品質を必ずフィルタリングしてください。インタラクションに基づくしきい値を捏造しないでください。


グループ単位の集計ルール

複数の銘柄が指定された場合は、次の順序を厳守してください。

  1. 銘柄ごとのフィルタリングとセンチメントのカウントを先に完了する
  2. 残した投稿をすべての銘柄から集め、1つのサンプルにまとめる
  3. 次の項目を計算する:
    • group_bull_pct
    • group_bear_pct
    • group_neutral_pct
    • group_post_count
  4. 1行の 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. シンボルが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を使用します。最も古いデータと最新のデータが同じ暦日の場合は、日付を1回だけ表示し、HH:mm ~ HH:mmに短縮してもかまいません。

正規化出力コントラクト

次のトップレベルフィールドを含む構造化オブジェクトを1つ返します。

フィールド型説明
requestobject有効なリクエストパラメーター
generated_atstringISO-8601形式の完了タイムスタンプ
modestringsingleまたはmulti
groupobject | nullmode=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グループ全体の1行要約
symbols[]
FieldTypeDescription
symbolstring対象のシンボル
statusstringok / error / empty
upstream_codeint32上流の生のステータス
upstream_messagestring上流の生のメッセージ
labelstringbullish / bearish / neutral / mixed
bull_pctstringパーセンテージ文字列
bear_pctstringパーセンテージ文字列
neutral_pctstringパーセンテージ文字列
post_countint32保持された投稿数
time_rangeobjectYYYY-MM-DD HH:mm(UTC+8)形式の { earliest: string, latest: string }。フィルター適用前の全バッチから算出
summarystringシンボルの概要を1行で記述
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. 1つのシンボルで上流の処理に失敗した場合も、バッチ結果は維持し、そのシンボルを失敗としてマークしてください。
  5. フィルター適用後に有効な投稿が少なすぎる場合は、過度な解釈を避け、根拠が限られていると伝えてください。
  6. 複数シンボルモードでは、グループ全体の結果を最初に出力し、その後にシンボルごとの内訳を出力してください。
  7. 注目度の高い意見は、重複を除いた要約とし、スパムのコピーをそのまま載せないでください。
  8. 売買の助言をしたり、将来の価格動向が確実であるかのように示唆したりしないでください。

認証

  • 公開ゲートウェイの利用では、文書化された契約上、通常は明示的な API キーは必要ありません。
  • 内部デプロイで後から認証が追加された場合は、環境変数またはシークレットストレージを使用し、このスキルにシークレットをハードコードしないでください。

セキュリティ

リクエストとデータ
  • すべてのシンボルをユーザー入力として扱い、URL エンコードしてください。
  • 表示前に HTML を除去してください。
  • 必要がない場合は、投稿本文の大きな生データをログに記録しないでください。
  • 内部ゲートウェイの詳細、Cookie、シークレットを公開しないでください。
免責事項
  • コミュニティのセンチメントは、議論サンプルの要約にすぎません。
  • センチメントは将来の価格動向を意味するものではありません。
  • 回答は情報提供のみを目的とし、投資助言ではありません。

User Agent ヘッダー

次の文字列を含む User-Agent ヘッダーを指定してください:futu-comment-sentiment/0.0.2 (Skill)

コメント