English Français العربية

io.github.pooriaarab/agentic-engage

السجل الرسمي الذكاء الاصطناعي والوكلاء

Plan and send approved engagement on social platforms.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.pooriaarab/agentic-engage؟

  • Drafts: Generate fixed template text with an AI-assistance disclosure.
  • Review: Approve or deny actions; execution requires approved status.
  • Queue: Deduplicate target IDs and keep an in-memory audit log.
  • HTTP adapter: POST target and text to an endpoint you supply.
  • Guards: Optional dispatch caps, UTC quiet hours, and text blocklists.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package agentic-engage
Claude Code 
claude mcp add agentic-engage -- npx -y agentic-engage@0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "agentic-engage": {
            "command": "npx",
            "args": [
                "-y",
                "agentic-engage@0.1.0",
                "mcp"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. agentic-engage
  2. Install
  3. Preview your first action
  4. Features and coverage
  5. Runtime surfaces
  6. Limits and status
  7. Links and license

agentic-engage

agentic-engage is an open-source engagement queue for Node.js developers and agents, with approval steps, local receipts, and a generic HTTP adapter.

Install

npm install agentic-engage

Requires Node.js 18 or later. Includes TypeScript declarations and two runtime dependencies.

Preview your first action

Save this as preview.mjs, then run node preview.mjs. No credentials are needed.

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

Success prints true approved and zero dispatch costs. Preview makes no delivery request.

Features and coverage

  • Drafts: Generate fixed template text with an AI-assistance disclosure.
  • Review: Approve or deny actions; execution requires approved status.
  • Queue: Deduplicate target IDs and keep an in-memory audit log.
  • HTTP adapter: POST target and text to an endpoint you supply.
  • Guards: Optional dispatch caps, UTC quiet hours, and text blocklists.
Target labelNative integration status
Redditscaffold; generic HTTP or local receipt only
X (Twitter)scaffold; generic HTTP or local receipt only
LinkedInscaffold; generic HTTP or local receipt only
YouTubescaffold; generic HTTP or local receipt only
Blueskyscaffold; generic HTTP or local receipt only
WebhookGeneric HTTP adapter implemented; endpoint supplied by caller

Six target labels share two engagement adapter classes. No native social API is credential-verified. Use new HttpEngagementAdapter("webhook", { endpoint }) in the library's adapters map. Your endpoint handles authentication and platform delivery. No vendor environment variables or .env loader exist.

Runtime surfaces

CLI commands: plan, queue, approve, deny, send, costs, and mcp; also --help and --version. Run npx agentic-engage mcp or npx --package agentic-engage agentic-engage-mcp for Model Context Protocol (MCP). Tools: plan_engagement, get_engagement_queue, approve_engagement, deny_engagement, execute_engagement, and get_cost_report. Worker source exposes GET /health, POST /summarize, and POST /plan; you deploy it yourself.

Limits and status

Queues and costs reset when the process exits. Separate CLI invocations do not share actions. CLI and MCP live execution use local receipts; they cannot configure HTTP adapters. Library execution also defaults to local receipts without an adapter, even with live: true. A sent status therefore does not prove social publication. HTTP receipts use locally generated IDs. HTTP requests default to a 10-second timeout with no retries. Costs count characters, not currency. Drafts use fixed text templates; no language model generates them. Account ownership is not verified. Version 0.1.0 has an API that may change. No managed social delivery service is included.

Package and releases · MIT license

الأسئلة الشائعة

ما هو io.github.pooriaarab/agentic-engage؟

Plan and send approved engagement on social platforms.

كيف أثبّت io.github.pooriaarab/agentic-engage؟

يعمل على جهازك. في Claude Code: claude mcp add agentic-engage -- npx -y agentic-engage@0.1.0 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.pooriaarab/agentic-engage إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.pooriaarab/agentic-engage مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.pooriaarab/agentic-engage؟

ينشره pooriaarab. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.