Metadata-Version: 2.4
Name: agentcrew-mcn
Version: 0.1.1
Summary: AI MCN 自动推广工具 — 你的AI营销团队，24小时在线工作，不领工资。
Author: super-rick
License-Expression: MIT
Project-URL: Homepage, https://github.com/super-rick/agent-crew
Project-URL: Bug Reports, https://github.com/super-rick/agent-crew/issues
Project-URL: Source, https://github.com/super-rick/agent-crew
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
Dynamic: license-file

# AgentCrew 🤖

<div align="center">

**你的 AI 营销团队，24 小时在线工作，不领工资。**

[![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/)

</div>

---

## 什么是 AgentCrew？

AgentCrew 是一个开源的多 Agent 内容营销自动化工具。它由一组 AI"员工"组成，自动完成从内容生成到跨平台分发的全流程。

- **Writer Agent** — 文案员工：生成技术文章、帖子、Thread
- **Publisher Agent** — 运营员工：发布到掘金、知乎、X/Twitter
- **Analyst Agent** — 数据分析员工：追踪效果、优化策略

## 核心特性

- 🧠 **多 Agent 架构** — 每个"员工"独立部署，可插拔
- 🔧 **Skills + Tools 系统** — 原子化操作 + 高级能力编排
- 📚 **RAG 知识库** — 基于历史内容和竞品情报的增强生成
- 🎯 **跨平台发布** — 支持掘金、知乎、X/Twitter 等平台
- ⏰ **智能调度** — 带随机抖动的定时发布，避免平台检测
- 🔮 **MCP 预留** — 架构预留 MCP 协议接口（v2 路线图）
- 📊 **Dashboard** — Web 面板查看发布数据和 Agent 状态
- 🔁 **自推广 Meta 闭环** — 项目自己推广自己

## 快速开始

### 方式一：pip 安装（推荐）

```bash
# 1. 安装
pip install agentcrew-mcn

# 2. 初始化配置
agent-crew init

# 3. 编辑 .env，填入你的 API Key
#    DEEPSEEK_API_KEY=sk-...

# 4. 开始使用
agent-crew write generate --topic "Python异步编程" --style technical
agent-crew publish post --file article.md --platform juejin --dry-run
```

> 💡 也可使用 `agentcrew-mcn` 命令，与 `agent-crew` 完全等价。

### 方式二：源码安装

```bash
# 1. 克隆项目
git clone https://github.com/super-rick/agent-crew.git
cd agent-crew

# 2. 安装依赖
pip install -r requirements.txt

# 3. 初始化配置
python -m cli.main init

# 4. 编辑 .env，填入 API Key
```

### 配置

`agent-crew init` 会自动创建配置文件模板。主要配置项：

```yaml
# config.yaml 核心配置
llm:
  api_key: ${DEEPSEEK_API_KEY}  # 从 .env 读取
  model: deepseek-chat

platforms:
  juejin:
    cookie: ${JUEJIN_COOKIE}    # 浏览器登录后导出 Cookie
```

### 使用

```bash
# 生成一篇技术文章
agent-crew write generate --topic "Python异步编程" --style technical

# 预览模式（不调用 LLM，查看参数）
agent-crew write generate --topic "Python异步编程" --dry-run

# 发布到掘金
agent-crew publish post --file article.md --platform juejin

# 启动定时发布（每6小时）
agent-crew schedule start --topic-file topics.txt --platform juejin --interval 6

# 管理 RAG 知识库
agent-crew rag ingest --file article.md --source "my_blog"
agent-crew rag search --query "AI Agent 架构"
```

## 架构概览

```
┌─────────────────────────────────────────────────────┐
│                   Orchestrator                       │
│              任务分派 / 调度引擎 / 配置管理              │
└──┬──────────┬──────────────┬────────────────────────┘
   │          │              │
┌──▼──────┐ ┌▼────────┐ ┌──▼────────┐
│ Writer  │ │Publisher│ │  Analyst  │
│ Agent   │ │Agent    │ │  Agent    │
│         │ │         │ │           │
│ Skills: │ │ Skills: │ │ Skills:   │
│ 追热点   │ │ 定时分发 │ │ 效果分析   │
│ 技术文章 │ │ 多平台  │ │ 趋势报告   │
│ Thread   │ │ 批量    │ │           │
│         │ │         │ │           │
│ Tools:  │ │ Tools:  │ │ Tools:    │
│ search  │ │ twitter │ │ analytics │
│ rag     │ │ juejin  │ │ compare   │
│ compose │ │ zhihu   │ │ report    │
└─────────┘ └─────────┘ └───────────┘
```

## 技术栈

| 组件 | 技术 |
|------|------|
| 语言 | Python 3.10+ |
| CLI | Click + Rich |
| LLM | DeepSeek API (OpenAI 兼容) |
| 向量库 | ChromaDB |
| 自动化 | Playwright |
| Dashboard | Streamlit + Plotly |

## 开发路线图

- **v0.1** ✅ Writer Agent + Publisher Agent + CLI + 掘金/知乎 + Dashboard + Analyst Agent
- **v0.2** 📝 X/Twitter 适配器 + 内容策略引擎
- **v1.0** 🎯 MCP 协议 + Skill Store + 社区插件

## License

MIT
