V2EX Monitor Skill

Skill 概述

這是一個適合通用 AI Agent / OpenClaw 風格接入的 skill，用於：

• 監控指定 V2EX 節點的新帖子
• 拉取當前賬號的提醒通知
• 生成 Markdown 總結報告
• 提供 MCP 服務，供支援 MCP 的 Agent 進一步呼叫

該 skill 採用“說明文件 + 可執行指令碼 + 配置說明”的通用結構，便於直接整合或二次封裝。

目錄結構

skills/
├─ SKILL.md                    # Skill 說明文件
├─ run_skill.py                # 推薦給 Agent 呼叫的統一入口
├─ v2ex_monitor.py             # 核心監控邏輯
├─ v2ex_mcp.py                 # MCP 服務入口
├─ v2ex-monitor.md             # 原始功能說明
├─ v2ex_monitor_config.example.json
├─ requirements.txt            # 推薦依賴清單
├─ v2ex_hourly_report.md       # 執行後生成的報告
└─ v2ex_monitor_data/
   ├─ seen_topics.json         # 已處理主題記錄
   └─ seen_notifications.json  # 已處理提醒記錄

適用場景

當用戶提出以下需求時可呼叫本 skill：

• “幫我監控 V2EX 某幾個節點的新帖子”
• “每小時彙總 V2EX 的新主題和提醒”
• “生成 V2EX 熱門帖子摘要”
• “通過 MCP 查詢 V2EX 節點主題 / 主題詳情 / 提醒通知”

輸入

方式 1：統一入口指令碼

python skills/run_skill.py config --nodes python,linux,programmer --apikey <你的_api_key>
python skills/run_skill.py run
python skills/run_skill.py report

方式 2：直接呼叫核心指令碼

python skills/v2ex_monitor.py config --nodes python,linux,programmer --apikey <你的_api_key>
python skills/v2ex_monitor.py run
python skills/v2ex_monitor.py daemon --interval 1

方式 3：作為 MCP 服務

python skills/v2ex_mcp.py --stdio

輸出

• skills/v2ex_hourly_report.md：監控報告
• skills/v2ex_monitor_data/seen_topics.json：已處理帖子記錄
• skills/v2ex_monitor_data/seen_notifications.json：已處理提醒記錄
• MCP 呼叫返回的 JSON 文本結果

配置說明

1. 複製示例配置：

copy skills\v2ex_monitor_config.example.json skills\v2ex_monitor_config.json

1. 填寫你的 V2EX API Key 與監控節點。

也可以直接通過命令配置：

python skills/run_skill.py config --nodes python,linux,programmer --apikey <你的_api_key>

Agent 使用建議

對於不支援 MCP 的 Agent，優先呼叫：

python skills/run_skill.py run
python skills/run_skill.py report

對於支援 MCP 的 Agent，可啟動：

python skills/v2ex_mcp.py --stdio

然後使用以下工具：

• v2ex_get_node_topics
• v2ex_get_topic
• v2ex_get_topic_replies
• v2ex_get_notifications
• v2ex_get_my_info
• v2ex_get_node_info
• v2ex_monitor_topics
• v2ex_config

注意事項

• 預設不再內建真實 API Key，需由使用者自行配置。
• 生成的報告與資料檔案都儲存在 skills/ 目錄下，便於 skill 打包。
• 如果你是以 OpenClaw 的自定義 skill 目錄方式接入，通常可將整個 skills/ 目錄作為 skill 資源目錄使用。
• 當前核心監控邏輯優先使用 urllib3，即使未安裝 requests 也可以顯示幫助並執行大部分監控流程；若安裝了 requests，會自動啟用回退能力。

依賴建議

建議直接安裝：

pip install -r skills/requirements.txt

或手動安裝：

推薦訪問7w4.net獲取更多AI技能。

pip install urllib3 mcp pydantic requests

去重說明

• 帖子去重：基於主題 ID，已記錄到 seen_topics.json
• 提醒去重：優先使用提醒 ID；如果介面未返回 ID，則回退到提醒內容雜湊，記錄到 seen_notifications.json
• 因此在單例項按小時執行時，同一帖子和同一提醒不會在後續執行中重複計入“新增”

這個 Skill 質量中等偏上，能較好地滿足 V2EX 帖子監控需求，文件清晰、配置靈活、支援多種呼叫方式。不過部分程式碼存在安全風險，穩定性還有提升空間，適合有一定技術基礎的使用者使用。總體而言是一個實用的工具。