Marketing Swarm
https://github.com/ruvnet/marketing- Category
- AI Agents
- Rank
- No. 1970Tools index
- Pricing
- Open Source
- Type
- AGENT
- Builder
- ruvnet
- GitHub
- 126 stars
- Date
About
An agentic marketing swarm framework for AI-driven campaigns and content workflows.
What it does
Marketing Swarm organizes campaign work among 15 specialist agents covering coordination, simulation, risk, creative analysis, attribution, account health, and cross-platform operations. A coordinator accepts typed tasks, routes them through queued agents, tracks state and metrics, and shares events between components. Users can start and inspect the swarm through commands or consume it as a TypeScript library.
Why it's ranked here
The architecture is unusually concrete for an ambitious marketing automation project. It exposes typed tasks, agent lifecycles, event history, domain services, validation, logging, caching, and status commands. The main reservation is a visible scope mismatch: documentation promises seven advertising platforms, while the supplied core platform type names only Google Ads, Meta, TikTok, and LinkedIn.
What's good
The agent boundaries teach a useful decomposition of marketing operations. Coordination, intelligence, creative work, attribution, and account operations occupy distinct tiers. The shared base handles queues, lifecycle state, metrics, task events, and failures, reducing repeated infrastructure. Public exports also cover campaign, creative, attribution, analytics, security, caching, connection pooling, and batching concerns.
Tradeoffs
Setup requires Node.js 20 or newer, npm, Claude-Flow initialization, and an Anthropic API key. Advertising credentials remain separate configuration. The documentation makes strong claims about continuous optimization, self-learning, performance, coverage, and broad platform support, but the supplied excerpts do not demonstrate those claims through test results or complete integration implementations. Typed platform coverage also trails the advertised list.
How to use it well
Use it as a TypeScript foundation for teams prototyping coordinated campaign analysis and automation with explicit task routing, events, metrics, and extension points. Start with one campaign workflow, connect only the required credentials, and validate agent outputs before permitting spend changes. Treat it as developer infrastructure requiring integration and operational controls, not a turnkey hosted replacement for advertising platforms or human campaign approval.
Technical notes+
package.json defines an ESM npm package requiring Node.js 20 or newer, with TypeScript compilation, Vitest, ESLint, swarm start and status scripts, and runtime dependencies for validation, events, logging, queues, identifiers, and Redis. src/index.ts exposes the coordinator, base agent, domain services, security utilities, caches, pooling, batching, and startup helper. src/core/event-bus.ts implements queued publish and subscribe behavior, bounded in-memory history, aggregate event storage, replay, wildcard subscriptions, and wait timeouts. src/agents/base-agent.ts centralizes per-agent queues, lifecycle management, metrics, task state transitions, and event emission. src/types/index.ts defines the domain model but its Platform union contains four platforms, despite README.md advertising seven. src/cli/swarm-start.ts and src/cli/swarm-status.ts provide process-oriented command interfaces.
Observed
- License
- MIT
- Primary language
- TypeScript
- Packaging
- ESM npm package named @marketing/ai-swarms
- Runtime requirement
- Node.js 20 or newer
- Interfaces
- TypeScript library plus swarm start and status commands
- Core architecture
- 15 agents arranged across five functional tiers
- Documented platform support
- Google Ads, Meta, TikTok, LinkedIn, Twitter/X, Pinterest, and Snapchat
Read from README.md, package.json, src/index.ts, src/core/index.ts, src/swarm/index.ts, src/types/index.ts, src/core/logger.ts, src/agents/index.ts, src/security/index.ts, src/services/index.ts, src/core/event-bus.ts, src/cli/swarm-start.ts, src/cli/swarm-status.ts, src/performance/index.ts, src/agents/base-agent.ts.
What it can do
Generate marketing campaign strategies
Campaign objectives and target audience parameters → AI-generated marketing campaign plans and strategies
Create marketing content at scale
Content requirements and brand guidelines → Generated marketing copy, social media posts, and advertising content
Orchestrate multi-agent marketing workflows
Marketing workflow definitions and campaign parameters → Coordinated execution of marketing tasks across multiple AI agents
Optimize campaign performance automatically
Campaign performance data and metrics → Optimized campaign parameters and recommendations
Analyze target audience segments
Customer data and market research inputs → Audience insights and segmentation recommendations
Generate personalized marketing messages
Customer profiles and campaign messaging requirements → Personalized marketing content tailored to specific audience segments
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.