Metadata-Version: 2.4
Name: agentcrew-mcn
Version: 0.2.0
Summary: AI MCN 自动推广工具 — 多Agent内容营销自动化，支持掘金/知乎/Dev.to
Author: super-rick
License-Expression: MIT
Project-URL: Homepage, https://github.com/super-rick/agentcrew-mcn
Project-URL: Bug Reports, https://github.com/super-rick/agentcrew-mcn/issues
Project-URL: Source, https://github.com/super-rick/agentcrew-mcn
Keywords: ai,mcn,marketing,agent,automation,content-marketing,multi-agent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai>=1.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: click>=8.1.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: chromadb>=0.5.0
Requires-Dist: schedule>=1.2.0
Requires-Dist: duckduckgo-search>=6.0.0
Requires-Dist: streamlit>=1.28.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: plotly>=5.0.0
Requires-Dist: markdown>=3.5.0
Requires-Dist: pygments>=2.17.0
Dynamic: license-file

# AgentCrew MCN 🤖

<div align="center">

**Your AI marketing team. Works 24/7. Never asks for a raise.**

[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)]()
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)]()
[![PyPI version](https://img.shields.io/badge/pypi-agentcrew--mcn-blue)](https://pypi.org/project/agentcrew-mcn/)
[![Tests](https://img.shields.io/badge/tests-88%20passed-brightgreen)]()

</div>

> 📖 [中文文档](README_CN.md) | English

---

## What is AgentCrew?

AgentCrew MCN is an open-source multi-agent content marketing automation tool. A team of AI "employees" handles the entire pipeline — from content creation to cross-platform distribution.

- **Writer Agent** — Copywriter: generates technical articles, social posts, and threads
- **Publisher Agent** — Operations: publishes to Juejin, Zhihu, Dev.to, and more
- **Analyst Agent** — Data Analyst: tracks performance and optimizes strategy

## Features

- 🧠 **Multi-Agent Architecture** — Each "employee" operates independently; pluggable design
- 🔧 **Skills + Tools System** — Atomic operations composed into high-level capabilities
- 📚 **RAG Knowledge Base** — Retrieval-augmented generation from historical content
- 🎯 **Cross-Platform Publishing** — Juejin, Zhihu, Dev.to with extensible adapters
- ⏰ **Smart Scheduling** — Time-based publishing with random jitter to avoid detection
- 🔮 **MCP-Ready** — Architecture reserved for MCP protocol (v2 roadmap)
- 📊 **Dashboard** — Web panel for post analytics and agent status
- 🔁 **Dogfooding** — The project promotes itself

## Quick Start

### Option 1: pip install (recommended)

```bash
# 1. Install
pip install agentcrew-mcn

# 2. Initialize config
agentcrew-mcn init

# 3. Edit .env with your API keys
#    DEEPSEEK_API_KEY=sk-...

# 4. Start using
agentcrew-mcn write generate --topic "Python async programming" --style technical
agentcrew-mcn publish post --file article.md --platform juejin --dry-run
```

> 💡 `agent-crew` is also available as an alias for `agentcrew-mcn`.

### Option 2: From source

```bash
# 1. Clone
git clone https://github.com/super-rick/agentcrew-mcn.git
cd agentcrew-mcn

# 2. Install dependencies
pip install -r requirements.txt

# 3. Initialize
python -m cli.main init

# 4. Edit .env with your API keys
```

### Configuration

`agentcrew-mcn init` creates a config template. Key settings:

```yaml
# config.yaml
llm:
  api_key: ${DEEPSEEK_API_KEY}  # Reads from .env
  model: deepseek-chat

platforms:
  juejin:
    cookie: ${JUEJIN_COOKIE}    # Export cookie from browser
  devto:
    api_key: ${DEVTO_API_KEY}   # https://dev.to/settings/extensions
```

### Usage

```bash
# Generate a technical article
agentcrew-mcn write generate --topic "Python async programming" --style technical

# Preview mode (no LLM call, inspect parameters)
agentcrew-mcn write generate --topic "Python async" --dry-run

# Publish to Juejin
agentcrew-mcn publish post --file article.md --platform juejin

# Scheduled publishing (every 6 hours)
agentcrew-mcn schedule start --topic-file topics.txt --platform juejin --interval 6

# RAG knowledge base
agentcrew-mcn rag ingest --file article.md --source "my_blog"
agentcrew-mcn rag search --query "AI Agent architecture"
```

## Architecture

```
┌─────────────────────────────────────────────────────┐
│                   Orchestrator                       │
│           Task dispatch / Scheduler / Config          │
└──┬──────────┬──────────────┬────────────────────────┘
   │          │              │
┌──▼──────┐ ┌▼────────┐ ┌──▼────────┐
│ Writer  │ │Publisher│ │  Analyst  │
│ Agent   │ │Agent    │ │  Agent    │
│         │ │         │ │           │
│ Skills: │ │ Skills: │ │ Skills:   │
│ trending│ │ schedule│ │ report    │
│ tech    │ │ multi   │ │ recommend │
│ thread  │ │ batch   │ │           │
│         │ │         │ │           │
│ Tools:  │ │ Tools:  │ │ Tools:    │
│ search  │ │ devto   │ │ analytics │
│ rag     │ │ juejin  │ │ compare   │
│ compose │ │ zhihu   │ │ report    │
└─────────┘ └─────────┘ └───────────┘
```

## Tech Stack

| Component | Technology |
|-----------|-----------|
| Language | Python 3.10+ |
| CLI | Click + Rich |
| LLM | DeepSeek API (OpenAI-compatible) |
| Vector DB | ChromaDB |
| Automation | Playwright |
| Dashboard | Streamlit + Plotly |

## Roadmap

See [ROADMAP.md](ROADMAP.md) for details.

- **v0.1** ✅ Writer + Publisher + CLI + Juejin/Zhihu + Dashboard + Analyst
- **v0.2** 📝 Dev.to adapter + Zhihu MD fix + Bilingual README
- **v0.3** 🔜 Skill Store + more platforms + A/B testing
- **v1.0** 🔮 MCP protocol + community plugins

## License

MIT
