agentic-engage

Name: agentic-engage
Author: pooriaarab

本地服务

github.com/pooriaarab社交媒体02 周前更新

代码仓库

关于 agentic-engage

agentic-engage 是面向 Node.js 开发者和 Agent 的开源互动任务队列，提供审批、本地回执和通用 HTTP 适配器。虽包含多个社交平台标签，但未实现原生平台投递；实际投递取决于调用方提供的端点。

主要功能

01用固定模板生成互动文本草稿
02执行前批准或拒绝操作
03去重目标并保留内存审计日志
04通过调用方配置的 HTTP 端点发送
05可选设置发送上限、静默时段和屏蔽词

适用场景

01准备待人工审批的互动操作
02在本地队列中跟踪计划和已完成操作
03将获批文本发送到指定 Webhook 端点
04在静默时段限制发送

MCP 相关

MCP 服务提供规划互动、查看队列、批准或拒绝操作、执行操作及获取成本报告的工具。MCP 执行使用本地回执，无法配置 HTTP 适配器。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "pooriaarab-agentic-engage": {
      "command": "npx",
      "args": [
        "-y",
        "agentic-engage"
      ]
    }
  }
}

启动命令npx -y agentic-engage

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmagentic-engage0.1.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
targets	array	是
personaVoice	string	是

详细介绍

agentic-engage

agentic-engage 是一款面向 Node.js 开发者和 Agent 的开源互动队列，支持审批步骤、本地回执和通用 HTTP 适配器。

安装

npm install agentic-engage

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

预览你的第一个操作

将以下内容保存为 preview.mjs，然后运行 node preview.mjs。无需凭据。

import {
  createEngagementQueue, planEngagement, approveEngagement,
  executeEngagement, getCostReport,
} from "agentic-engage";

const queue = createEngagementQueue();
const [draft] = planEngagement(
  [{ id: "post-1", platform: "webhook", context: "your launch" }],
  "Helpful brand", queue,
);
approveEngagement(draft.id, queue);
const preview = await executeEngagement(draft.id, { queue });
console.log(preview.dryRun, preview.action.status); // true approved
console.log(getCostReport()); // entries: [], dispatches: 0, units: 0

成功时会打印 true approved，且派发成本为零。预览不会发送任何请求。

功能与支持情况

草稿： 使用 AI 辅助说明生成固定模板文本。
审核： 批准或拒绝操作；只有已批准的操作才能执行。
队列： 对目标 ID 去重并维护内存审计日志。
HTTP 适配器： 将目标和文本 POST 到你提供的端点。
防护措施： 可选的派发上限、UTC 安静时段和文本屏蔽列表。

目标标签	原生集成状态
Reddit	脚手架；仅支持通用 HTTP 或本地回执
X (Twitter)	脚手架；仅支持通用 HTTP 或本地回执
LinkedIn	脚手架；仅支持通用 HTTP 或本地回执
YouTube	脚手架；仅支持通用 HTTP 或本地回执
Bluesky	脚手架；仅支持通用 HTTP 或本地回执
Webhook	已实现通用 HTTP 适配器；由调用方提供端点

六个目标标签共用两种互动适配器类。没有任何原生社交 API 经过凭据验证。在库的 adapters 映射中使用 new HttpEngagementAdapter("webhook", { endpoint })。你的端点负责处理身份验证和平台派送。本项目不包含供应商环境变量或 .env 加载器。

运行时接口

CLI 命令：plan、queue、approve、deny、send、costs 和 mcp；另有 --help 和 --version。运行 npx agentic-engage mcp 或 npx --package agentic-engage agentic-engage-mcp 以使用模型上下文协议（MCP）。工具：plan_engagement、get_engagement_queue、approve_engagement、deny_engagement、execute_engagement 和 get_cost_report。 Worker 源码公开了 GET /health、POST /summarize 和 POST /plan；需要自行部署。

限制与状态

进程退出后，队列和成本会重置。不同的 CLI 调用不会共享操作。 CLI 和 MCP 的实时执行使用本地回执；它们无法配置 HTTP 适配器。即使设置了 live: true，库在没有适配器时也默认使用本地回执执行。因此，sent 状态并不能证明内容已发布到社交平台。HTTP 回执使用本地生成的 ID。 HTTP 请求默认超时时间为 10 秒，且不会重试。成本按字符数计算，不代表货币金额。草稿使用固定文本模板，不由语言模型生成。不会验证账号所有权。版本 0.1.0 的 API 可能会变更。本项目不包含托管式社交媒体派送服务。