agentic-scout

agentic-scout

パッケージ · ソースとサポート

agentic-scoutは、公開されている会話を調査する開発者向けの、オープンソースのスレッド検索ライブラリです。Reddit、Hacker News、RSSフィードを検索します。ローカルでのスコアリングと固定テンプレートにより、スレッドを順位付けし、コンテンツのアイデアを作成します。

インストール

npm install agentic-scout

Node.js 18以降が必要です。TypeScript宣言ファイルと、実行時に直接使用する2つの依存関係が含まれています。

最初のスレッドを見つける

これを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フィード	✓ 基本的なアイテム／エントリーパーサー	ライブフィードアクセスは未確認
ローカルフィクスチャ	✓ 提供されたスレッドレコード	ローカルの例で検証済み

ディスパッチャーは、ネットワークソース3つとフィクスチャ1つの、4つのソース経路を実装しています。 認証情報を確認済みの連携機能は謳っていません。ネットワークの可用性は、上流のエンドポイントに依存します。

よくある使用例

1. Node.js開発者が、調査ダッシュボード向けにHacker Newsのストーリーを取得する。
2. TypeScriptチームが、ローカルのヒューリスティックを使って提供されたRedditのレコードを順位付けする。
3. MCPクライアントのユーザーが、コンテンツのアイデアを作成する前にスレッドを採点する。
4. RSSツールの開発者が、Node.jsスクリプト内のクエリを使ってフィードエントリーを絞り込む。

機能

• 検索： SDKのオプションには、サブレディット、RSS URL、結果数の上限、フィクスチャ、差し替え可能なfetchが含まれます。
• スコアリング： タイトルに基づく関連性、エンゲージメントの速度、購入意図を示す語句、競合状況をスコア化します。
• 順位付け： 合計スコアに基づいて提供されたレコードを並べ、同点の場合はタイトルで順序を決めます。
• アイデア： 最大10件のテンプレートベースのカードに、情報源へのリンクと開示文が含まれます。
• ユーティリティ： SDKの共通ヘルパーは、テキスト統計、ガード、ローカルルーティング、HTTPルーティングを提供します。

ランタイムの利用方法

Node.js SDK は、searchThreads、scoreOpportunity、rankThreads、suggestIdeas と、共有のコアユーティリティをエクスポートします。

CLI には、search、trends、ideas、summary、dispatch、costs、mcp の 7 つのコマンドがあります。 ヘルプを表示するには --help または -h を使用してください。バージョンを表示するには --version または -V を使用してください。 検索とアイデアには --query が必要です。trends では固定クエリ trending を使用します。 検索コマンドでは --platforms、--dry-run、--live を指定できます。 summary では --text と --top、dispatch では --text と --dry-run を指定できます。

npx agentic-scout mcp

MCP ツールは、summarize_text、dispatch_text、score_opportunity、rank_threads、suggest_ideas、search_threads、get_cost_report の 7 つです。 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 ルーティングのデフォルトタイムアウトは 10 秒で、再試行はありません。 コストレポートには、請求合計ではなく、プロセス内の配信ユニットが保存されます。検索のコストは記録されません。

連携ガイド

オフラインアプリケーションには、フィクスチャのクイックスタートを使用してください。RSS の場合は、MCP 検索ツールに sources: ["rss"] と rssUrl を渡してください。 SDK では、searchThreads(query, ["rss"], { rssUrl }) を使用してください。 リポジトリのメタデータには、公開ドキュメントサイトが設定されていません。

ステータス

バージョン 0.1.0 は初期リリースであり、インターフェースは変更される可能性があります。問題はGitHub サポートから報告してください。 このリポジトリでは、公開事例はまだ公開されていません。 コンテンツを公開する前に、情報源の事実を確認し、開示文を作成してください。

FAQ

agentic-scout とは何ですか？

agentic-scout は、公開スレッドを検索してランキングするライブラリです。テンプレートベースのコンテンツアイデアカードも作成します。

どの連携が検証済みですか？

agentic-scout は、Reddit、Algolia 経由の Hacker News、RSS、フィクスチャに対応しています。ローカルのフィクスチャ例は検証済みですが、ライブエンドポイントへのアクセスは未対応です。

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。