{"skill":{"slug":"v2ex-monitor","displayName":"v2ex-monitor","summary":"监控指定 V2EX 节点的新帖与提醒，生成 Markdown 汇总报告，支持 MCP 查询和定时拉取数据。","description":"# V2EX Monitor Skill\n\n## Skill 概述\n\n这是一个适合通用 AI Agent / OpenClaw 风格接入的 skill，用于：\n\n- 监控指定 V2EX 节点的新帖子\n- 拉取当前账号的提醒通知\n- 生成 Markdown 总结报告\n- 提供 MCP 服务，供支持 MCP 的 Agent 进一步调用\n\n该 skill 采用“说明文档 + 可执行脚本 + 配置说明”的通用结构，便于直接集成或二次封装。\n\n## 目录结构\n\n```text\nskills/\n├─ SKILL.md                    # Skill 说明文档\n├─ run_skill.py                # 推荐给 Agent 调用的统一入口\n├─ v2ex_monitor.py             # 核心监控逻辑\n├─ v2ex_mcp.py                 # MCP 服务入口\n├─ v2ex-monitor.md             # 原始功能说明\n├─ v2ex_monitor_config.example.json\n├─ requirements.txt            # 推荐依赖清单\n├─ v2ex_hourly_report.md       # 运行后生成的报告\n└─ v2ex_monitor_data/\n   ├─ seen_topics.json         # 已处理主题记录\n   └─ seen_notifications.json  # 已处理提醒记录\n```\n\n## 适用场景\n\n当用户提出以下需求时可调用本 skill：\n\n- “帮我监控 V2EX 某几个节点的新帖子”\n- “每小时汇总 V2EX 的新主题和提醒”\n- “生成 V2EX 热门帖子摘要”\n- “通过 MCP 查询 V2EX 节点主题 / 主题详情 / 提醒通知”\n\n## 输入\n\n### 方式 1：统一入口脚本\n\n```bash\npython skills/run_skill.py config --nodes python,linux,programmer --apikey <你的_api_key>\npython skills/run_skill.py run\npython skills/run_skill.py report\n```\n\n### 方式 2：直接调用核心脚本\n\n```bash\npython skills/v2ex_monitor.py config --nodes python,linux,programmer --apikey <你的_api_key>\npython skills/v2ex_monitor.py run\npython skills/v2ex_monitor.py daemon --interval 1\n```\n\n### 方式 3：作为 MCP 服务\n\n```bash\npython skills/v2ex_mcp.py --stdio\n```\n\n## 输出\n\n- `skills/v2ex_hourly_report.md`：监控报告\n- `skills/v2ex_monitor_data/seen_topics.json`：已处理帖子记录\n- `skills/v2ex_monitor_data/seen_notifications.json`：已处理提醒记录\n- MCP 调用返回的 JSON 文本结果\n\n## 配置说明\n\n1. 复制示例配置：\n\n```bash\ncopy skills\\v2ex_monitor_config.example.json skills\\v2ex_monitor_config.json\n```\n\n2. 填写你的 V2EX API Key 与监控节点。\n\n也可以直接通过命令配置：\n\n```bash\npython skills/run_skill.py config --nodes python,linux,programmer --apikey <你的_api_key>\n```\n\n## Agent 使用建议\n\n对于不支持 MCP 的 Agent，优先调用：\n\n```bash\npython skills/run_skill.py run\npython skills/run_skill.py report\n```\n\n对于支持 MCP 的 Agent，可启动：\n\n```bash\npython skills/v2ex_mcp.py --stdio\n```\n\n然后使用以下工具：\n\n- `v2ex_get_node_topics`\n- `v2ex_get_topic`\n- `v2ex_get_topic_replies`\n- `v2ex_get_notifications`\n- `v2ex_get_my_info`\n- `v2ex_get_node_info`\n- `v2ex_monitor_topics`\n- `v2ex_config`\n\n## 注意事项\n\n- 默认不再内置真实 API Key，需由使用者自行配置。\n- 生成的报告与数据文件都保存在 `skills/` 目录下，便于 skill 打包。\n- 如果你是以 OpenClaw 的自定义 skill 目录方式接入，通常可将整个 `skills/` 目录作为 skill 资源目录使用。\n- 当前核心监控逻辑优先使用 `urllib3`，即使未安装 `requests` 也可以显示帮助并执行大部分监控流程；若安装了 `requests`，会自动启用回退能力。\n\n## 依赖建议\n\n建议直接安装：\n\n```bash\npip install -r skills/requirements.txt\n```\n\n或手动安装：\n\n```bash\npip install urllib3 mcp pydantic requests\n```\n\n## 去重说明\n\n- 帖子去重：基于主题 ID，已记录到 `seen_topics.json`\n- 提醒去重：优先使用提醒 ID；如果接口未返回 ID，则回退到提醒内容哈希，记录到 `seen_notifications.json`\n- 因此在单实例按小时执行时，同一帖子和同一提醒不会在后续运行中重复计入“新增”","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":706,"installsAllTime":26,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773221795890,"updatedAt":1778997819520},"latestVersion":{"version":"1.0.0","createdAt":1773221795890,"changelog":"V2EX Monitor Skill 1.0.0 — First release\n\n- Monitor specified V2EX nodes for new posts and notifications.\n- Generates Markdown summary reports and saves tracking data to avoid duplicates.\n- Provides both command-line tools and MCP service entry for seamless integration with AI Agents and automation tools.\n- Modular structure with clear configuration, supporting both direct and MCP-based invocation.\n- No API key included—user must configure their own.","license":"MIT-0"},"metadata":null,"owner":{"handle":"minglu6","userId":"s17dpbyc9yh0k09z30d96bcz45884aq0","displayName":"minglu6","image":"https://avatars.githubusercontent.com/u/155623115?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089838097}}