1. 项目定位与用途
last30days-skill 定位为'由人群评分而非编辑的搜索引擎',是一个 AI 代理驱动的多源搜索技能。其核心用途是聚合过去 30 天内跨社交平台、技术社区和预测市场的实时公众讨论与参与数据,帮助用户在需要快速掌握某个话题、人物或企业近期动态的场景中,获取经过 AI 合成、基于证据的简明摘要。与传统搜索引擎不同,它直接访问平台原生数据(如 Reddit 评论 upvotes、X 帖子 likes、Polymarket 资金下注),提供'人们实际在讨论什么'的原始洞察,省去手动浏览多个平台的繁琐过程。
2. 解决的问题
该项目主要解决三个问题:一是信息孤岛问题,Reddit、X、YouTube 等平台各自为政,API 独立、认证分离,传统搜索引擎无法索引其深层对话数据;二是时效性与真实性矛盾,搜索引擎依赖网页快照,难以获取过去 30 天的实时讨论,且结果受 SEO 优化影响;三是信号噪声比低,社区讨论中充斥低质量内容,需要基于真实用户参与度进行筛选。last30days-skill 通过用户自备 API 密钥和浏览器会话桥接孤岛,并行搜索后按人群参与度评分,最终由 AI 代理法官合成高信噪比摘要。
3. 适用场景
适用场景包括:销售前调研——在销售电话前快速了解目标企业过去 30 天的真实动态、产品发布和社区反馈;人物背景调查——会议前阅读某人的近期推文、YouTube 转录和 GitHub 提交记录;旅行规划——查询目的地的最新评价,如设施关闭情况和用户体验;产品开发——验证某个问题是否真实存在,了解社区讨论的解决方案;以及跟踪 AI 领域动态——由于信息更新极快,Reddit 和 X 上的技术讨论往往领先数月。本质上,任何需要'过去一个月真实人群观点'而非'编辑精选内容'的决策前场景都适用。
4. 安装方式
仓库中明确给出两种安装途径:一是通过 Claude Code 插件市场,在 Claude Code 中输入命令 `/plugin marketplace add mvanhorn/last30days-skill` 即可添加;二是通过 OpenClaw 生态,使用命令 `clawhub install last30days-official` 安装。两种方式均设计为零配置体验——Reddit、Hacker News、Polymarket 和 GitHub 可立即使用,首次运行时会触发交互式设置向导,引导用户在约 30 秒内配置 X、YouTube、TikTok 等需要 API 密钥或浏览器会话的平台。项目要求 Python 3.12+ 环境,依赖仅 requests 库,但具体本地开发安装步骤(如 pip install)在 README 中未明确给出。
5. 使用方式
使用方式极为简洁:在已安装插件的 Claude Code 环境中,直接输入命令 `/last30days [查询主题]` 即可触发搜索和摘要生成。例如 `/last30days Peter Steinberger` 会返回该人物过去 30 天在 OpenAI 工作、参与 Codex 项目、与 Anthropic 政策争议、提交 PR 以及社区讨论等动态的综合摘要。命令后可直接跟人物姓名、公司、产品、技术话题或任何感兴趣的主题。系统会自动解析查询意图,并行调用各平台搜索,融合、重排、去重后由 AI 代理合成最终报告。高级用户可通过 `--days=N` 参数调整时间范围,但核心交互保持单一命令形式。
6. 补充说明与实现特点
技术实现上,项目采用并行执行架构,Reddit 与 X 搜索通过 ThreadPoolExecutor 并发发起;Reddit 搜索基于 OpenAI Responses API 的 web_search 工具并域名过滤至 reddit.com,随后调用免费 JSON API enrich 真实 upvotes 数据;X 搜索优先使用 Bundled Bird(环境验证),失败则降级至 xAI API,体现多后端容错设计;数据处理流程包含解析、融合、标准化、过滤、评分、去重等阶段,最终输出至 SKILL.md 代理。质量评估方面,项目包含本地评估脚本,可比较不同版本输出的 Jaccard 相似度、保留率及可选 Gemini 裁判指标(Precision@5、nDCG@5)。值得注意的是,项目 v3 管道为当前主版本,技能规范以 skills/last30days-v3/SKILL.md 为准。