agentic-analytics

agentic-analytics

软件包 · 输入指南 · API · 支持

agentic-analytics 是一款面向开发者和 Agent 的开源社交帖子分析工具包。它会对提供的指标进行排名、比较内容格式，并给出基于规则的后续行动建议。报告可通过 JavaScript SDK、命令行界面（CLI）或模型上下文协议（MCP）服务在本地生成。

安装

npm install agentic-analytics

请使用 Node.js 18 或更高版本。软件包包含 TypeScript 声明，并有两个直接运行时依赖项。

为你的第一篇帖子评分

保存一个示例指标文件。无需凭据或环境变量。

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 提供本地计算库，用于处理你已有的指标。 你可以在脚本和 Agent 工作流中使用它的报告函数，无需连接社交账号。

对比

对比日期：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 让 Agent 对提供的指标进行排名。
4. 内容团队： 从 CSV 生成 Markdown 报告，用于审核文档。

功能

• **验证：**要求提供平台、钩子、格式以及六项非负数值指标。
• **排名：**按分数排序，其次依次按潜在客户转化率、互动率和展示次数排序。
• **格式对比：**按格式汇总展示次数、互动量、潜在客户数和平均分数。
• **建议：**根据分数阈值分配 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。 四种分析工具均通过 text 接受 JSON 或 CSV。analytics_report 还可接受可选的 markdown。

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

可自托管的 Worker 源码提供 GET /health 和 POST /report。 报告请求必须包含 JSON 请求体，其中有一个指标 text 字符串。 此软件包不提供托管端点。

交付与行为限制

分析函数不会获取指标、发布帖子，也不会将潜在客户归因于转化。 你必须提供可比较的测量数据和一致的时间范围。 互动量等于点赞数加评论数加分享数。点击数会被保留，但不会影响分数。 分数等于 engagementRate * 100 + leadRate * 500；上限不限于 100。 比率以展示次数为分母。展示次数为零时，比率也为零。 建议采用相对分数阈值，不使用训练模型或统计显著性检验。 recommendNext 需要接收已排序的列表；请先调用 rankPosts。 不同平台上标签相同的格式会合并分组。 CSV 解析支持带引号的逗号和转义引号，但不支持多行单元格。 分析功能不会记录成本单位。通用 SDK 分发工具会在进程内存中跟踪字符单位，而非货币。 HTTP 文本路由器的默认超时时间为十秒，且不内置重试或身份验证标头。

集成指南

请提供下方列出的所有字段。JSON 也接受 { "posts": [...] }。 导入前，请将平台导出数据转换为此架构；目前没有品牌专属的导出适配器。

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

数值必须为有限的非负数。平台、钩子和格式标签不能为空。 调用报告函数前，请使用 parseMetricsText 验证输入。 本地分析无需加载 .env。

状态

版本 0.1.0 是早期版本。1.0 之前，API 和建议规则可能会发生变化。 报告 Bug 或请求支持。 此仓库尚未发布公开案例研究。 贡献者可以运行 npm run build、npm run typecheck 和 npm test。

常见问题

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 针对固定的指标架构提供本地函数和 Agent 工具。Hootsuite Analytics 则提供基于账户的仪表板和报告。

agentic-analytics 能获取 LinkedIn 指标吗？

agentic-analytics 不会获取 LinkedIn 指标。请将数据转换为所需架构，并以 JSON 或 CSV 格式传入。

下一步行动由 AI 模型生成吗？

agentic-analytics 使用确定性的评分阈值分配下一步行动。文本模板使用你提供的格式、平台和吸引点。

agentic-analytics 需要 API 密钥吗？

analytics 功能不需要 API 密钥。其独立的 HTTP 文本工具会将数据发送到你选择的端点。

agentic-analytics 如何为帖子评分？

agentic-analytics 将互动率乘以 100，再加上线索率乘以 500。点击量会被存储，但不计入此公式。

许可证

MIT。版权所有 Pooria Arab。