AI-powered marketing agent with persistent memory — chat-first, multi-provider
AI-powered marketing agent that lives in your chat.
Telegram, Discord, Slack — or build your own channel.
Build in public, automate your marketing, never forget your campaigns.
MarketClaw is an AI marketing assistant that:
Think of it as your marketing co-pilot that's always on, always learning, and never forgets a campaign.
# Clone
git clone https://github.com/helixdata/MarketClaw.git
cd MarketClaw
# Install
npm install
# Setup (interactive, ~3 minutes)
npx tsx src/cli.ts setup
# Start
npx tsx src/cli.ts start
That's it. Open your configured channel (Telegram, Discord, or Slack) and start chatting.
Use any AI provider:
| Provider | Description |
|---|---|
| Anthropic | Claude models (default) |
| OpenAI | GPT-4o, o1, etc. |
| Groq | Ultra-fast inference |
| Gemini | Google's models |
| Ollama | Local models, privacy |
| OpenRouter | Access any model |
Works where you already are — Telegram, Discord, Slack, or CLI. Natural conversation, inline buttons, image sharing.
You: "Schedule a tweet about our new feature for tomorrow 9am"
Bot: ✅ Scheduled! I'll post "..." tomorrow at 9:00 AM.
You: "What posts are scheduled this week?"
Bot: 📅 3 posts scheduled:
• Tomorrow 9am - Twitter
• Wed 2pm - LinkedIn
• Fri 10am - Twitter thread
MarketClaw remembers:
~/.marketclaw/workspace/
├── BRAND.md # Your brand voice
├── products/ # Product details
├── campaigns/ # Campaign history
└── knowledge/ # Product knowledge base
Delegate tasks to specialized AI agents:
| Agent | Name | Specialty |
|---|---|---|
| 🐦 | Tweety | Twitter threads, viral hooks |
| 💼 | Quinn | LinkedIn, B2B content |
| ✉️ | Emma | Email marketing, outreach |
| 🎨 | Pixel | Visual content, images |
| 📊 | Dash | Analytics, metrics |
| 🔍 | Scout | Research, competitor intel |
| 🚀 | Hunter | Product Hunt launches |
You: "Ask Tweety to write a thread about building in public"
Bot: 🐦 Tweety completed the task:
1/ Building in public is scary. Here's why you should do it anyway...
Multi-user support with roles:
You: "Add @jane as a creator for ProofPing"
Bot: ✅ Added Jane to the team (creator for ProofPing)
Quality control for team content:
Creator: "Request approval for this tweet"
Bot: 📝 Notifying approvers...
Manager: "approve"
Bot: ✅ Approved! Ready to post.
Define your brand for consistent content:
You: "Set ProofPing brand colors: primary #FF6B35, accent #00D9C0"
Bot: ✅ Updated brand colors for ProofPing
You: "ProofPing voice is warm and reassuring, never corporate"
Bot: ✅ Updated brand voice for ProofPing
You: "What are ProofPing's brand guidelines?"
Bot: 🎨 ProofPing Brand:
Colors: primary #FF6B35, accent #00D9C0
Voice: warm, reassuring friend
Tagline: "Someone's always got your back"
The agent automatically uses brand guidelines when creating content.
Search the web and extract content for research:
You: "Research AI marketing trends"
Bot: # Research: AI marketing trends
Found 5 sources:
1. **The Rise of AI in Marketing** - How brands are using...
2. **Marketing Automation 2024** - Key trends to watch...
You: "Search for Product Hunt launch tips from this week"
Bot: Found 5 recent results:
• How to Launch on Product Hunt (2 days ago)
• Top Tips from #1 Products (5 days ago)
...
You: "Fetch the content from https://example.com/article"
Bot: Extracted 3,500 characters from the article...
Tools: web_search, web_fetch, research_topic
Store and search product images:
You: "Add this screenshot to ProofPing" [attaches image]
Bot: ✅ Added "screenshot.png" to ProofPing library
You: "Find ProofPing screenshots showing the dashboard"
Bot: 📸 Found 3 images:
• App Store Hero (screenshot) - iPhone showing main dashboard
• Dashboard Dark Mode (screenshot) - Dark theme variant
• Check-in Flow (screenshot) - Step-by-step check-in
You: "List all ProofPing logos"
Bot: 📸 2 logo images found...
Features:
Send images and MarketClaw can analyze them:
You: [sends competitor's landing page screenshot]
"What's good about this landing page?"
Bot: Here's my analysis:
✅ Clear value proposition above the fold
✅ Strong social proof with logos
⚠️ CTA could be more prominent
...
Works across Telegram, Discord, and Slack with Claude, GPT-4o, and Gemini.
Post to social media via Chrome extension — no API costs, posts like a human:
| Platform | Actions |
|---|---|
| 🐦 Twitter/X | Post |
| Post | |
| Post, comment | |
| Comment, DM | |
| 🔶 Hacker News | Submit, comment, upvote |
| 🚀 Product Hunt | Upvote, comment |
| Post, comment, like | |
| 🧵 Threads | Post, reply, like |
| 🦋 Bluesky | Post, reply, like, repost |
| ▶️ YouTube | Comment, like, subscribe |
You: "Post to Twitter: Just shipped a new feature! 🚀"
Bot: ✅ Posted to Twitter successfully
You: "Upvote this Product Hunt launch"
Bot: ✅ Upvoted on Product Hunt
You: "Comment on this HN post: Great insights!"
Bot: ✅ Comment posted to Hacker News
Multi-account support: Name your Chrome profiles (Work, Personal, Client1) and target specific accounts:
You: "Post to Twitter from my work account: Company announcement"
Bot: ✅ Posted to Twitter (Work profile)
See extension/README.md for setup and full documentation.
Monitor and control API spending:
You: "How much have we spent this week?"
Bot: 💰 Total: $12.45 (156 operations)
By Tool: generate_image: $8.00, send_email: $2.15
By Agent: Pixel: $8.00, Emma: $2.15
By Provider: gemini: $8.00, resend: $2.15
You: "Set a $50 monthly budget"
Bot: ✅ Budget "Monthly Limit" created: $50/monthly (global)
Features:
# Required
TELEGRAM_BOT_TOKEN=your-token
# AI Provider (pick one)
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
GROQ_API_KEY=gsk_...
GOOGLE_API_KEY=AIza...
OPENROUTER_API_KEY=sk-or-...
# Optional integrations
RESEND_API_KEY=re_...
BRAVE_SEARCH_API_KEY=BSA...
TWITTER_COOKIES=...
~/.marketclaw/config.yaml:
telegram:
botToken: ${TELEGRAM_BOT_TOKEN}
allowedUsers: [123456789]
providers:
default: anthropic
anthropic:
model: claude-sonnet-4-5-20250514
agent:
name: MarketClaw
emoji: 🦀
voice: friendly # professional, casual, friendly, playful
persona: your friendly marketing assistant
See docs/SETUP.md for detailed configuration.
src/
├── index.ts # Agent startup
├── cli.ts # CLI commands
├── setup.ts # Interactive setup wizard
├── providers/ # AI providers (swappable)
│ ├── anthropic.ts
│ ├── openai.ts
│ ├── groq.ts
│ ├── gemini.ts
│ ├── ollama.ts
│ └── openrouter.ts
├── channels/ # Chat interfaces (modular)
│ ├── telegram.ts
│ ├── discord.ts
│ ├── slack.ts
│ └── cli.ts
├── browser/ # Browser automation
│ ├── extension-bridge.ts # WebSocket server
│ └── tools.ts # 18 browser tools
├── agents/ # Sub-agent system
│ ├── specialists.ts # Built-in specialists
│ ├── registry.ts # Agent management
│ └── tools.ts # delegate_task, etc.
├── team/ # Multi-user management
│ ├── manager.ts # Team CRUD
│ ├── permissions.ts # Tool-level permissions
│ └── tools.ts # Team management tools
├── approvals/ # Content approval workflow
│ ├── manager.ts # Approval logic
│ └── tools.ts # approve, reject, etc.
├── tools/ # Agent capabilities
│ ├── scheduler-tools.ts
│ ├── knowledge-tools.ts
│ ├── twitter-tools.ts
│ └── ...
├── memory/ # Persistent state
├── knowledge/ # RAG/embeddings
└── scheduler/ # Cron jobs
extension/ # Chrome extension
├── manifest.json # Extension manifest (v0.4.0)
├── background.js # WebSocket client
├── popup.html/js # Extension UI
└── content-scripts/ # Platform automation (10 platforms)
# Agent
marketclaw start # Start the agent
marketclaw setup # Interactive setup
marketclaw status # Show status
# Products
marketclaw products list
marketclaw products add "ProductName" --tagline "..."
# Knowledge
marketclaw kb init <product>
marketclaw kb index <product>
marketclaw kb search <product> "query"
# Scheduling
marketclaw cron list
marketclaw cron add -s "every day at 9am" -m "Check metrics"
# Config
marketclaw config
Contributions welcome! See CONTRIBUTING.md.
# Development
npm run dev # Watch mode
npm run typecheck # Type checking
npm run lint # Linting
MIT © Brett Waterson
Built with 🦀 for indie hackers who'd rather ship than schedule
FAQs
AI-powered marketing agent with persistent memory — chat-first, multi-provider
The npm package marketclaw receives a total of 2 weekly downloads. As such, marketclaw popularity was classified as not popular.
We found that marketclaw demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
NIST disclosed an unreleased AI tool called V-etalon and opened a broad inquiry into NVD modernization after years of automation plans produced no public enrichment system.
Security News
In his AI Council 2026 talk, Feross Aboukhadijeh covers recent package compromises, vulnerability discovery, and a more automated security model.
Security News
A new federal program will let vetted U.S. cybersecurity firms help investigate and disrupt foreign cybercrime groups under government direction.