agentic-analytics

agentic-analytics

パッケージ · 入力ガイド · API · サポート

agentic-analytics は、開発者やエージェント向けのオープンソースのソーシャル投稿分析ツールキットです。指定された指標をランキングし、形式を比較して、ルールベースの次のアクションを提示します。レポートは、JavaScript SDK、コマンドラインインターフェース（CLI）、または Model Context Protocol（MCP）サーバーを通じてローカルで実行されます。

インストール

npm install agentic-analytics

Node.js 18 以降を使用してください。TypeScript の型宣言が含まれています。このパッケージには、実行時の直接依存関係が 2 つあります。

最初の投稿をスコアリングする

サンプルの指標ファイルを保存します。認証情報や環境変数は必要ありません。

cat > metrics.json <<'JSON'
[{"platform":"LinkedIn","hook":"Stop guessing","format":"carousel","impressions":1000,"likes":40,"comments":8,"shares":5,"clicks":30,"leads":4}]
JSON
npx agentic-analytics report --file metrics.json --markdown

レポートには Posts: 1、Engagement rate: 5.30%、Lead rate: 0.40% と出力されます。 このサンプルでは、次のアクションとして double-down が提示されます。 SDK でも同じレポートが生成されます。

import { createReport, reportMarkdown } from 'agentic-analytics';

const report = createReport([{
  platform: 'LinkedIn', hook: 'Stop guessing', format: 'carousel',
  impressions: 1000, likes: 40, comments: 8, shares: 5,
  clicks: 30, leads: 4,
}]);
console.log(reportMarkdown(report));

仕組み

JSON / CSV → normalize metrics → score and rank → compare formats
                                             → recommend next moves
                                             → JSON / Markdown report
                SDK / CLI / MCP share these functions

開発の背景

Buffer Insights と Hootsuite Analytics は、ソーシャルレポートのダッシュボードを提供しています。 agentic-analytics は、すでにお持ちの指標を計算するローカルライブラリを提供します。 ソーシャルアカウントに接続せずに、スクリプトやエージェントのワークフローでレポート関数を使用できます。

比較

ソースおよびリンク先の製品ドキュメントに基づき、2026-10-14 に確認しました。

範囲	agentic-analytics	Buffer Insights	Hootsuite Analytics
インターフェース	SDK、CLI、MCP	Buffer ダッシュボード	Hootsuite レポート
入力	指定された JSON または CSV	接続済みのソーシャルチャネル	接続済みソーシャルアカウントのデータ
実行	お使いの Node.js プロセス	管理されたアプリケーション	管理されたアプリケーション
レポート出力	JSON と Markdown	ダッシュボード。有料プランでは PDF または CSV	ダッシュボードとレポートのエクスポート

Buffer は、Insights ガイドでチャネルへのアクセスについて説明しています。 Hootsuite は、レポートのエクスポートガイドでエクスポートについて説明しています。

対応範囲

ブランド別のプラットフォームコネクターはありません。platform はユーザーが指定するラベルであり、インテグレーションの選択項目ではありません。

入力／サーフェス	ステータス	範囲
JSON 配列	実装済み	投稿指標
posts 配列を含む JSON オブジェクト	実装済み	投稿指標
CSV	実装済み	固定フィールドスキーマ
ソーシャルネットワーク API	—	アカウント接続やデータ取得には非対応
汎用 HTTP テキストルーター	SDK ユーティリティ	{text} をお使いのエンドポイントに送信します。指標コネクターではありません
ローカルテキストルーター	ローカルでの受信記録のみ	外部への配信には非対応

ローカルテストでは、解析、スコアリング、公開されているサーフェスを検証します。分析に関して検証が必要なプロバイダー認証情報はありません。

主なユースケース

1. LinkedIn アナリスト： エクスポートした指標をスキーマに変換してから、カルーセル形式とテキスト形式を比較します。
2. Node.js 開発者： 内部レビュー用スクリプトに createReport を組み込みます。
3. MCP クライアント開発者： エージェントに rank_posts を通じて指定した指標をランキングするよう依頼します。
4. コンテンツチーム： CSV からレビュー文書用の Markdown レポートを生成します。

機能

• 検証： プラットフォーム、フック、形式、および6つの0以上の数値指標が必要です。
• ランキング： スコア、リード率、エンゲージメント率、インプレッション数の順に並べ替えます。
• 形式の比較： 形式ごとにインプレッション数、エンゲージメント数、リード数、平均スコアを集計します。
• 推奨： スコアのしきい値に基づいて、double-down、revise、dropを割り当てます。
• レポート： 合計、ランキング順の投稿、形式の比較、推奨事項をJSONまたはMarkdownで出力します。
• テキストユーティリティ： テキスト統計、汎用ルーター、ガード、プロセス内コストカウンターを分析機能とは別にエクスポートします。

ランタイムの機能

分析SDKでは、normalizePost、parseMetricsText、scorePost、rankPosts、compareFormats、recommendNext、createReport、reportMarkdownをエクスポートします。 SDKではさらに、summarizeText、dispatchText、ローカルルーターとHTTPルーター、およびログ、ガード、コストのヘルパーもエクスポートします。

CLIのデータコマンドはingest、rank、recommend、reportです。いずれも--fileが必要です。 その他のコマンドはcostsとmcpです。引数なし、--help、または-hでヘルプを表示します。 バージョンは--versionまたは-Vで表示します。helpとversionを単独のコマンドとして使用することはできません。

npx agentic-analytics ingest --file metrics.json
npx agentic-analytics rank --file metrics.json
npx agentic-analytics recommend --file metrics.json
npx agentic-analytics report --file metrics.json --markdown
npx agentic-analytics costs
npx agentic-analytics mcp

MCP ツールはingest_metrics、rank_posts、recommend_next、analytics_report、get_cost_reportです。 4つの分析ツールは、textを通じてJSONまたはCSVを受け付けます。analytics_reportは、任意のmarkdownも受け付けます。

{"mcpServers":{"agentic-analytics":{"command":"npx","args":["agentic-analytics","mcp"]}}}

セルフホスト可能なWorkerのソースは、GET /healthとPOST /reportを提供します。 レポートのリクエストには、指標を含むtext文字列を含むJSON本文が必要です。 このパッケージでは、マネージドエンドポイントは提供されません。

提供形態と動作上の制限

分析関数は、指標の取得、投稿の公開、リードからコンバージョンへの紐付けを行いません。 比較可能な測定値と一貫した期間を指定する必要があります。 エンゲージメント数は、いいね数、コメント数、シェア数の合計です。クリック数は保持されますが、スコアには影響しません。 スコアはengagementRate * 100 + leadRate * 500です。100を上限としません。 率の分母にはインプレッション数を使用します。インプレッション数が0の場合、率は0になります。 推奨では、学習済みモデルや統計的有意性検定ではなく、相対的なスコアのしきい値を使用します。 recommendNextには、すでにランキングされたリストが必要です。先にrankPostsを呼び出してください。 形式のグループ化では、プラットフォームをまたいで同じ形式ラベルをまとめます。 CSVの解析では、引用符で囲まれたカンマとエスケープされた引用符をサポートしますが、複数行のセルはサポートしません。 分析機能ではコスト単位を記録しません。汎用SDKのディスパッチユーティリティは、通貨ではなく文字数をプロセスメモリ内で追跡します。 HTTPテキストルーターのデフォルトのタイムアウトは10秒です。組み込みの再試行機能や認証ヘッダーはありません。

統合ガイド

以下に示すすべてのフィールドを指定してください。JSONでは{ "posts": [...] }も受け付けます。 プラットフォームのエクスポートデータは、このスキーマに変換してからインポートしてください。特定ブランド向けのエクスポートアダプターはありません。

platform,hook,format,impressions,likes,comments,shares,clicks,leads
LinkedIn,Stop guessing,carousel,1000,40,8,5,30,4

数値は有限かつ0以上である必要があります。プラットフォーム、フック、形式の各ラベルは空にできません。 レポート関数を呼び出す前に、parseMetricsTextを使用して入力を検証してください。 ローカル分析では.envの読み込みは不要です。

ステータス

バージョン0.1.0は初期リリースです。APIと推奨ルールは1.0より前に変更される可能性があります。 バグの報告またはサポートのリクエスト。 公開事例は、このリポジトリではまだ公開されていません。 コントリビューターはnpm run build、npm run typecheck、npm testを実行できます。

FAQ

agentic-analyticsは何を分析しますか？

agentic-analyticsは、指定されたソーシャル投稿の指標を分析します。エンゲージメント率、リード率、ランキング、形式ごとのサマリーを計算します。

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

agentic-analyticsには、特定ブランド向けのソーシャルネットワーク連携はありません。ローカルテストでは、JSONとCSVの計算経路を検証します。

agentic-analyticsはマネージド分析ダッシュボードを提供しますか？

agentic-analyticsはプロセス内で実行され、レポートを返します。マネージドダッシュボードや永続的な指標ストアは提供しません。

agentic-analytics は Buffer Insights とどう違いますか？

agentic-analytics は、指定した指標からレポートを計算します。Buffer Insights は、接続済みのチャネルについて Buffer 内でレポートを提供します。

agentic-analytics は Hootsuite Analytics とどう違いますか？

agentic-analytics は、固定の指標スキーマに対応したローカル関数とエージェントツールを提供します。Hootsuite Analytics は、アカウントベースのダッシュボードとレポートを提供します。

agentic-analytics は LinkedIn の指標を取得できますか？

agentic-analytics は LinkedIn の指標を取得しません。データを必要なスキーマに変換し、JSON または CSV として渡してください。

次のアクションは AI モデルによって生成されますか？

agentic-analytics は、決定論的なスコアのしきい値を使って次のアクションを割り当てます。テキストテンプレートでは、指定した形式、プラットフォーム、フックを使用します。

agentic-analytics に API キーは必要ですか？

分析に API キーは必要ありません。別途用意された HTTP テキストユーティリティは、選択したエンドポイントにデータを送信します。

agentic-analytics は投稿をどのようにスコアリングしますか？

agentic-analytics は、エンゲージメント率に 100 を掛けた値を、リード率に 500 を掛けた値に加算します。クリック数は保存されますが、この計算式には含まれません。

ライセンス

MIT。著作権者：Pooria Arab。