agentic-scout

agentic-scout

软件包 · 源代码和支持

agentic-scout 是一个开源讨论串发现库，面向研究公开对话的开发者。它可搜索 Reddit、Hacker News 和 RSS 订阅源。通过本地评分和固定模板生成排序后的讨论串及内容创意草稿。

安装

npm install agentic-scout

需要 Node.js 18 或更高版本。包含 TypeScript 类型声明和两个直接运行时依赖项。

找到你的第一个讨论串

将以下内容保存为 scout-demo.mjs，然后运行 node scout-demo.mjs。无需凭据、环境变量或 .env 加载器。

import { searchThreads, suggestIdeas, getCostReport } from "agentic-scout";

const threads = await searchThreads("Node.js", ["fixture"], {
  fixtures: [{
    id: "demo", title: "Node.js tools", source: "fixture",
    url: "https://nodejs.org/", score: 10, comments: 2,
  }],
});
console.log(threads.length, suggestIdeas(threads)[0].hook);
console.log(getCostReport());

成功运行后会输出 1 Why Node.js tools is getting attention right now，并显示空的成本报告。 示例数据在本地运行。不传入来源参数调用 searchThreads 会立即查询 Reddit 和 Hacker News。

使用 CLI 预览网络搜索：

npx agentic-scout search --query "Node.js" --platforms reddit,hackernews

此操作会输出 dryRun: true 和 approvalRequired: true。自行批准网络访问后，再添加 --live。

工作原理

Query -> Reddit / Hacker News / RSS / fixtures
                         |
                    Thread records
                         |
                Heuristic opportunity scores
                         |
                 Ranked threads / draft ideas

存在的意义

开发者可以在自己的应用程序中组合公开讨论串检索和本地评分。F5Bot 提供关键词提醒；Feedly 提供关注来源的工作流。 此软件包提供可编程的搜索结果和内容创意草稿。

对比

范围依据所链接的官方文档于 2026-10-14 核查。

范围	agentic-scout	F5Bot	Feedly
工作流	按需搜索和本地排序	关键词监控和邮件提醒	关注研究来源
配置	SDK 参数、CLI 标志、MCP 输入	关键词	来源和订阅源
运行方式	由用户运行的 Node.js 软件包	服务	服务

覆盖范围

来源	检索方式	验证情况
Reddit	✓ 公开搜索 JSON	实时访问待验证
通过 Algolia 访问 Hacker News	✓ 故事搜索 JSON	实时访问待验证
RSS 订阅源	✓ 基础项目解析器	实时订阅源访问待验证
本地示例数据	✓ 提供的讨论串记录	本地示例已验证

分发器实现了四条来源路径：三个网络来源和一条示例数据路径。 不宣称支持经过凭据验证的集成。网络是否可用取决于上游端点。

常见用例

1. Node.js 开发者为研究仪表板检索 Hacker News 故事。
2. TypeScript 团队使用本地启发式规则对提供的 Reddit 记录排序。
3. MCP 客户端用户在起草内容创意前先为讨论串评分。
4. RSS 工具构建者在 Node.js 脚本中使用查询筛选订阅源条目。

功能

• 搜索： SDK 选项包括 subreddit、RSS URL、结果数量限制、示例数据和注入的 fetch。
• 评分： 评分维度涵盖基于标题的相关性、互动增长速度、购买意向词和竞争程度。
• 排序： 按总分对提供的记录排序；标题用于打破平局。
• 创意： 最多生成十张基于模板的卡片，包含来源链接和披露文本。
• 实用工具： 共享 SDK 辅助工具提供文本统计、校验、本地路由和 HTTP 路由。

运行时接口

Node.js SDK 导出 searchThreads、scoreOpportunity、rankThreads 和 suggestIdeas，以及共享的核心工具函数。

七个 CLI 命令：search、trends、ideas、summary、dispatch、costs 和 mcp。 使用 --help 或 -h 获取帮助；--version 或 -V 可打印版本号。 搜索和创意命令需要 --query；趋势命令使用固定查询 trending。 搜索命令接受 --platforms、--dry-run 和 --live。 摘要命令接受 --text 和 --top；分发命令接受 --text 和 --dry-run。

npx agentic-scout mcp

七个 MCP 工具：summarize_text、dispatch_text、score_opportunity、rank_threads、suggest_ideas、search_threads 和 get_cost_report。 MCP 网络搜索必须同时设置 live: true 和 approved: true。

仓库中的 Worker 处理程序提供 GET /health 和 POST 路由 /summarize、/score、/rank 和 /ideas。 用户需要自行部署该源代码。它不是托管端点，也不是包导出项。

交付与行为限制

搜索没有分页、重试、内置超时、缓存或去重功能。数据源按顺序运行；任何一个数据源出错都会导致整个搜索停止。 Reddit 和 Hacker News 请求各自获取 25 条记录。合并后的默认上限为 50 条。 RSS 使用基础正则表达式解析器；它无法完整实现 RSS 或 Atom。

相关性依据标题长度和标签，而非与搜索查询的相似度。分数不能证明购买意向，也无法预测内容是否会走红。 创意生成使用固定模板，不调用模型 API。LinkedIn 和 X（Twitter）是创意标签，并非发布集成。

CLI 支持 RSS，但无法提供 rssUrl；使用 SDK 或 MCP 处理信息流。 CLI 接受 --file，但缺少其默认读取器。统计和本地分发请使用 --text。 CLI 实时搜索需要 --live；没有单独的审批标记。SDK 搜索会直接发起网络请求。

本地分发只会生成回执，不会向外部投递。通用 SDK HTTP 路由的默认超时为十秒，且不进行重试。 成本报告记录的是进程本地的分发单位数，而非账单总额。搜索不会记录成本。

集成指南

离线应用请使用 fixture 快速入门。对于 RSS，请在 MCP 搜索工具中传入 sources: ["rss"] 和 rssUrl。 在 SDK 中，使用 searchThreads(query, ["rss"], { rssUrl })。 仓库元数据中未配置公共文档站点。

状态

版本 0.1.0 属于早期版本；接口可能会变更。请通过 GitHub 支持报告问题。 此仓库尚未发布公开案例研究。 发布内容前，请核实源信息并拟好披露说明。

常见问题

什么是 agentic-scout？

agentic-scout 是一个公开的帖子搜索和排名库。它还可以生成基于模板的内容创意卡片。

哪些集成已经过验证？

agentic-scout 实现了 Reddit、通过 Algolia 接入的 Hacker News、RSS 和 fixtures。已验证本地 fixture 示例；实时端点访问尚待验证。

agentic-scout 是否提供托管监控服务？

agentic-scout 在你自己的进程中运行。它不提供定时监控或托管警报。

agentic-scout 与 F5Bot 有何不同？

agentic-scout 提供按需搜索和本地排名。F5Bot 会监控关键词并通过电子邮件发送警报。

agentic-scout 与 Feedly 有何不同？

agentic-scout 通过开发者 API 返回帖子记录。Feedly 提供关注信息源的工作流。

它能保证创意走红吗？

agentic-scout 不会预测内容是否会走红。其分数只是启发式评估，创意则基于固定模板。

搜索会以试运行模式执行吗？

agentic-scout CLI 搜索默认会预览，而 SDK 搜索会直接执行。MCP 搜索需要明确传入实时模式和审批参数。

它会发布到 LinkedIn 或 X 吗？

agentic-scout 使用 LinkedIn 和 X 作为创意标签。它没有社交媒体发布适配器。

许可证

MIT。