项目快照：mvanhorn/last30days-skill，约 65,834 个 Star，5,728 个 Fork；最新推送时间 2026-10-28T16:30:58Z。本文基于仓库公开资料撰写。

项目地址：https://github.com/mvanhorn/last30days-skill

last30days-skill 从代码、运行环境到实践流程的项目封面
last30days-skill 的项目能力与实践流程示意。

项目速览（TL;DR）

last30days-skill 是一个用于代理式研究（agent-led research）的多来源技能：它围绕一个主题检索近期网络内容，将不同来源的信号汇总并交由 AI 判断器合成为简报。仓库资料将主要时间范围描述为最近 30 天；具体执行行为以仓库中的运行时技能规范和最新 README 为准。

  • 仓库资料：默认分支为 main，语言标注为 Python，许可证为 MIT。
  • GitHub 元信息：65834 stars、5728 forks。该数字来自用户提供的仓库资料，不代表持续更新的实时统计。
  • 项目版本：pyproject.toml 中的版本号为 3.31.0，Python 要求为 3.12 或更高。
  • 安装入口：README 提供 Claude Code 插件安装方式，以及面向 Codex、Cursor、Copilot、Gemini CLI 等 Agent Skills 宿主的 npx skills 安装命令。

仓库定位不是单一内容站点的搜索客户端，而是把多个来源的检索结果纳入同一研究流程。具体数据是否可取，取决于来源本身、可选工具、用户授权的登录会话或凭据。

定位与目标用户

项目试图回答“某个主题、公司或人物最近在发生什么”，而不是只返回传统网页索引结果。README 描述的目标用户包括需要在会议、销售沟通、产品开发或旅行准备前了解近期讨论的人。

其研究方式把社区互动和来源内容作为线索，例如 Reddit 的投票与评论、X 的帖子、YouTube 字幕文本、GitHub 活动及 Polymarket 的市场赔率。它们是不同性质的证据，不能视为同一种可靠性指标；对结论进行核查时仍需回到原始来源。

“An AI agent-led search engine scored by upvotes, likes, and real money - not editors.”

来源：README。

README 把“people, not editors”作为产品表达，指向的是按平台参与信号组织信息的思路。它不意味着社区热度能够证明事实，也不意味着项目可以覆盖每个平台上的全部内容。

核心功能

核心工作流由并行检索、跨来源整理和 AI 综合组成。用户以自然语言主题发起查询，技能依据可用来源采集近期材料，并把来源内容与参与信号交给综合环节形成简报。

能力 工作方式 触发条件或依赖 输出或用途
多来源主题研究 针对同一主题并行检索不同平台，再进行汇总。 可立即使用的来源包括 Reddit、Hacker News、Polymarket 和 GitHub；其他来源可能需要首次配置或显式启用。 用于整理近期讨论、观点和相关材料。
按互动信号排序 README 描述会参考 upvotes、likes、评论及市场赔率等信号。 信号取决于具体来源提供的数据。 帮助研究者观察内容的关注度，不构成事实验证。
YouTube 字幕研究 检索视频字幕文本，并从长内容中提取可引用片段。 来源配置及字幕可用性会影响结果；更细的实现细节未提供。 用于补充视频讨论和访谈中的文字证据。
人物与组织研究 README 描述可将社交内容、播客字幕和 GitHub 活动等近期材料合并观察。 需要相应来源可用，并且检索对象能够被来源匹配。 支持会前准备或销售沟通背景研究。
AI 综合 由 AI agent judge 对采集结果进行综合，形成一份 brief。 模型选择、提示词、调用方式及费用控制未在所给资料中说明。 将多来源材料组织成摘要；仍应保留来源核查环节。

例如，README 给出以 Peter Steinberger 为主题的命令示例，并描述从 X、Reddit、YouTube 和 GitHub 活动中整理信息的场景。该案例是 README 的项目示例，不应被理解为对当前人物状态的独立核实。

系统架构与关键模块

从仓库资料可以确认，运行时技能规范位于 skills/last30days/SKILL.md，README 将其称为最新命令和安装行为的事实来源。完整的模块图、内部数据结构和模块间接口没有包含在用户提供的资料中，因此这里仅描述可以由 README 支撑的处理边界。

  • 技能入口：用户通过代理宿主调用 /last30days，或者按所用宿主的安装方式注册该技能。命令参数和更多子命令应以 SKILL.md 为准。
  • 来源采集：检索工作覆盖多个平台；不同来源具有不同认证、工具和启用条件。README 明确列出一部分无需 API key 的来源，也列出需要凭据或本地工具的来源。
  • 信号整理：各来源提供的互动、时间和内容信息可用于组织结果。README 没有披露统一评分公式、权重、去重算法或时间窗边界处理规则。
  • 综合输出：AI 判断器将采集到的内容合成为简报。其具体模型、调用接口、输出 schema 和失败重试机制，官方仓库未提供该信息，建议以最新 README 为准。
  • 可选研究入口：README 还提及本地 Markdown、文本文件和 PDF 的本地语料能力，但用户提供的摘录在该条目处截断，索引方式及支持边界未完整提供。

README 还提到 Perplexity 的 Agent API 综合、OpenRouter Sonar 回退、原始 Search API 结果和显式 Deep Research。这些描述属于来源能力介绍；相关配置字段、调用顺序及错误语义未在所给资料中展开。

依赖与运行环境

可以从项目元数据确定 Python 版本要求和开发依赖组，但运行时依赖情况不能只凭开发依赖列表推断。pyproject.toml 中项目的 dependencies 为空数组；这不等于全部可选来源都无需外部 CLI、账号或网络服务。

项目 资料中的值 说明
包名 last30days-skill 来自 pyproject.toml 的 project.name。
版本 3.31.0 来自 pyproject.toml 的 project.version。
Python 要求 >=3.12 来自 pyproject.toml 的 requires-python。
运行时依赖声明 [] 来自 pyproject.toml 的 project.dependencies。
开发依赖 pytest、pytest-cov、pytest-xdist、pyyaml、towncrier 版本范围见仓库 pyproject.toml；这些条目属于 dev 依赖组。
代理宿主 Claude Code、Codex、Cursor、Copilot、Gemini CLI 等 README 提供了相应安装方向；并未在所给资料中给出逐一兼容矩阵。

开发依赖的版本范围分别为 pytest >=9.1.1,<10、pytest-cov >=7,<8、pytest-xdist >=3.8,<4、pyyaml >=6.0.2,<7 和 towncrier >=25.8.0,<27。是否需要安装这些工具，取决于是否要运行测试或维护发行说明；普通用户的完整安装前置条件，官方仓库未提供该信息，建议以最新 README 为准。

快速开始（含最小可运行示例）

README 给出了两类安装入口：Claude Code 使用 marketplace 命令，其他列出的 Agent Skills 宿主可使用 npx skills。以下示例采用后者，并用 README 中的主题命令完成运行验证。

Bash
npx skills add mvanhorn/last30days-skill -g
/last30days Peter Steinberger

第一行是 README 提供的全局安装命令；第二行是 README 中的主题查询示例。运行命令应放在已安装技能且支持该技能的代理宿主中执行，不是直接在任意 shell 中当作 Python 命令运行。

README 称 Reddit、Hacker News、Polymarket 和 GitHub 可在零配置情况下使用；首次运行的设置向导可用于开启 X、YouTube、TikTok、arXiv、Techmeme 等更多来源。资料未给出各宿主安装后的验证输出、成功标志或测试查询，因此验证应以宿主中实际出现的研究结果及来源标注为准。

若使用 Claude Code，README 给出的安装方式如下。插件市场安装和 npx skills 安装是不同入口，选用其一并遵循对应宿主的安装流程。

Bash
/plugin marketplace add mvanhorn/last30days-skill
/plugin install last30days

以上命令均来自 README。安装过程是否要求额外授权、网络访问或宿主版本条件，官方仓库未提供该信息，建议以最新 README 为准。

配置说明

README 表明项目存在首次运行设置向导，并针对不同来源列出凭据、本地工具或显式启用条件。所给资料没有提供可完整核对的配置文件样例或配置 schema，因此表中缺失项如实标记为未提供。

字段名 类型 默认值 作用
INCLUDE_SOURCES 环境变量；具体格式未提供 未提供 README 将 dev.to、DripStack 等列为可通过该变量选择的来源。
TRUTHSOCIAL_TOKEN 令牌；具体格式未提供 未提供 用于认证后搜索 Truth Social 帖子。
SCRAPECREATORS_API_KEY API key；具体格式未提供 未提供 Telegram 公共频道来源的所需凭据之一；README 另要求频道列表。
--search xhs 命令行选项；参数类型未提供 未提供 显式请求 Xiaohongshu 来源；还要求本地运行的已登录 x-mcp 浏览器插件或 xiaohongshu-mcp 服务。
--devto-tags 命令行选项；参数类型未提供 未提供 README 列出的 dev.to opt-in 入口；完整参数格式未提供。
--hiring-signals 命令行选项；参数类型未提供 未提供 用于选择招聘信号相关的职位与职业页面来源。

表内出现环境变量和选项是因为它们明确出现在 README 摘录中，不代表这是完整配置清单。缺少的默认值、取值类型、配置文件位置和优先级，官方仓库未提供该信息，建议以最新 README 为准；不要从变量名称推测凭据格式或权限范围。

进阶用法

进阶用法的重点是按研究问题选择来源，而不是把所有来源都无差别开启。README 提供的来源描述涵盖社交讨论、技术社区、研究论文、媒体聚合、金融情绪、商品评论和本地语料等类别。

  • 人物或公司背景：README 描述可结合 X、YouTube 字幕、GitHub 活动等信息观察近期公开活动。实际覆盖范围受来源认证和公开内容可检索性限制。
  • 技术主题：Hacker News 提供社区讨论，GitHub 提供 issues、discussions 等项目线索，arXiv 可补充研究论文。arXiv CLI 在 README 中描述为首次设置安装、位于 PATH 后自动启用。
  • 消费者产品：Amazon 可提供评分、价格和评论，但需已认证的 brightdata CLI，并会使用用户的 Bright Data credits。Trustpilot 来源要求 trustpilot-pp-cli 和可用会话。
  • 招聘信号：README 指出可通过 --hiring-signals、--search jobs 或研究计划选择公开职位信息；具体命令签名需查阅运行时技能规范。
  • 中文生活与消费主题：Xiaohongshu 来源通过 --search xhs 显式请求，并要求已登录的 x-mcp 浏览器插件或本地 xiaohongshu-mcp 服务运行。
  • 本地资料：README 摘录提到本地 Markdown、文本文件和 PDF，但条目不完整；目录指定、格式限制和隐私隔离方式应核对最新 SKILL.md。

如果某一来源需要额外凭据，应先确认凭据是否属于该用户有权访问的账号或服务，再决定是否启用。来源产出代表它实际检索到的材料，不应把“没有结果”解读成“没有相关事件”。

可观测性与运维

仓库资料可以确认项目配置了 GitHub Actions 的 validate 工作流徽章，并在 pyproject.toml 中定义 pytest 测试设置与覆盖率门槛。资料没有提供运行时日志格式、指标、告警、服务端部署拓扑或 SLA，因此不能据此承诺线上可用性。

  • 测试配置的发现目录为 tests，测试文件匹配 test_*.py，pytest 默认使用 -q 和 --tb=short。
  • 覆盖率配置对 skills/last30days/scripts 统计分支覆盖率，排除 vendor 与 dist 路径；fail_under 设置为 81。
  • 开发依赖中包括 pytest-xdist，说明项目声明了相关测试工具依赖；资料没有给出推荐并行度或测试时长。
  • 发行说明由 towncrier 配置管理，变更片段目录为 changelog.d，目标文件为 CHANGELOG.md。

这些是仓库维护侧的配置，不等同于用户侧运行监控。运行日志保留策略、来源失败时的退出行为、重试策略、速率限制和结果缓存机制，官方仓库未提供该信息，建议以最新 README 和 SKILL.md 为准。

安全与合规边界

项目会聚合公开内容，也可以使用登录会话、API 凭据和第三方服务，因此使用者应对授权范围、个人信息处理和服务条款承担审查责任。此项目介绍不构成绕过访问控制、规避平台限制或访问未授权数据的指引。

  • 仅配置自己拥有或获准使用的账号、令牌、浏览器会话及第三方服务凭据。
  • 对 X、YouTube、Amazon、Trustpilot、Telegram 等来源，先核对对应平台和服务的适用条款、数据用途与保存限制。
  • 不要把 API key、会话 cookie 或其他秘密写入公开仓库、日志、共享研究简报或问题报告；所给资料没有说明项目的秘密存储机制。
  • 研究人物时限制收集到任务所需的公开信息，避免把社区讨论或推测当作未经核实的个人事实。
  • 在组织环境中使用时，依据组织的数据分类、审计和留存要求决定是否允许输入内部材料或个人数据。

项目是否保存原始数据、AI 请求是否发送到第三方模型、数据删除方式及地域处理方式，官方仓库未提供该信息，建议以最新 README 和各服务政策为准。对高敏感内容，应先完成组织内部的隐私与合规评估。

许可证与商用条款

仓库 LICENSE 文件声明采用 MIT License。许可证文本允许在满足其条件的前提下使用、复制、修改、合并、发布、分发、再许可及销售软件副本；商用使用不被该许可证文本排除。

分发软件或其实质部分时，必须在所有副本或重要部分中保留版权声明和许可声明。许可证按“现状”提供，并明确排除包括适销性、特定用途适用性和非侵权在内的保证；责任范围以仓库 LICENSE 原文为准。

仓库版权行写明 Copyright (c) 2026 Matt Van Horn。第三方来源服务、模型、平台内容和外部工具不因项目采用 MIT 而自动获得相同授权；涉及它们的使用权应分别核查，以仓库 LICENSE 和相关服务条款为准。

局限性与已知限制

项目的结果取决于来源能否访问、查询是否匹配以及内容是否可被检索。README 所列来源并不具有统一的接入条件：有些无需 API key，有些依赖认证、本地 CLI、第三方服务或用户主动选择。

  • “最近 30 天”是项目名称及 README 的主要研究定位，但所给资料没有说明不同来源是否采用完全相同的时区、起止时刻和回溯规则。
  • 参与度信号反映平台上的互动或市场赔率，不等于代表性抽样、事实证明或因果关系。
  • README 表示 Reddit、Hacker News、Polymarket 和 GitHub 可零配置使用；不能据此推断其他来源也无需设置。
  • 不同平台的内容访问、API 限制、字幕可用性和认证状态会影响检索结果；具体错误处理规则未提供。
  • 提示词、模型来源、引用校验、去重策略、数据缓存和结果复现能力未在所给资料中完整说明。
  • 本地语料能力的 README 条目不完整，支持的 PDF 类型、最大文件量和索引生命周期均未提供。

项目生成的是研究辅助材料，不是对全网信息的穷尽检索。对决策有实质影响的陈述，应回到原始帖子、论文、代码变更或服务页面核对发布时间、语境和出处。

适合谁／不适合谁

是否采用该项目，关键在于团队是否需要跨来源的近期研究，以及能否接受对来源接入和证据核验的持续管理。以下判断依据 README 和项目元数据；超出资料范围的建议均标注为作者判断。

适合谁

  • 需要在销售会议、客户沟通或人物会面前，聚合近期公开讨论，并愿意核查原始来源的个人或小团队。
  • 日常研究主题跨越 Reddit、Hacker News、X、YouTube 或 GitHub，并希望由代理宿主统一发起查询的使用者。
  • 能够运行 Python 3.12 或更高版本项目要求，并能按来源需要配置授权凭据或本地工具的技术团队。
  • 需要将社区讨论、内容材料和 Polymarket 赔率作为不同类型线索并列观察，而不把互动热度当作结论的研究者。

不适合谁

  • 需要有 SLA、审计报告、数据处理承诺或正式支持合同，但尚未从项目方取得相关信息的组织。
  • 要求一次查询必然覆盖所有平台、所有帖子或精确保证时间窗边界的场景；这些保证未见于所给资料。
  • 不能为第三方账号、API、浏览器会话或本地 CLI 的授权与维护指定责任人的团队。
  • 计划将代理摘要直接作为高风险决策证据，而不保留来源链接和人工复核环节的业务流程。根据本文作者的经验判断，这类流程需要额外的事实审查和留痕机制。

常见问题与排查（FAQ / Troubleshooting）

排查时先确认调用宿主、安装方式和目标来源，再检查来源各自的授权条件。README 提供了部分明确条件，但没有给出完整错误码或诊断命令。

安装后找不到技能

先核实是否在目标代理宿主中执行了对应安装流程：Claude Code 使用 README 中的 marketplace 命令，其他列出的 Agent Skills 宿主使用 npx skills add。宿主发现技能失败时的缓存清理或诊断命令，官方仓库未提供该信息，建议以最新 README 为准。

查询没有返回某个来源的结果

确认该来源是否默认可用、是否需要首次设置、是否要求显式 opt-in，以及所需的本地工具或凭据是否存在。README 明确指出 TikTok、arXiv、Techmeme 等来源与设置向导或 PATH 上的 CLI 有关，不能仅凭安装成功推断所有来源已启用。

Xiaohongshu 来源未工作

README 要求显式使用 --search xhs，并要求已登录的 x-mcp 浏览器插件或 xiaohongshu-mcp 服务在本地运行。服务状态检查和认证故障排查步骤未提供。

Telegram 或 Truth Social 来源为空

Telegram 需要 SCRAPECREATORS_API_KEY 和频道列表，且 README 明确写明它面向指定频道，并非关键词发现。Truth Social 来源需要 TRUTHSOCIAL_TOKEN；两类来源的令牌申请、权限和错误响应细节未提供。

需要确认项目当前运行行为

README 明确指出运行时技能规范位于 skills/last30days/SKILL.md，并作为最新命令和设置行为的事实来源。仓库版本、安装说明或来源支持发生变化时，应以默认分支 main 上的最新仓库资料复核。

项目地址与资源

以下链接仅列出项目仓库和所给 README 中出现的项目官方站点或资源入口。页面内容、可用性与版本可能随仓库更新而变化。