# 安装
pip install -e '.[dev]'

# 一键从热门选题到成稿
xhs-skill generate --topic "通勤防晒" --search-provider fixture --output output/package.json

# 或者用 MCP 接入你的 AI Agent
python -m xhs_skill.mcp.server --transport stdio

# 1. 安装
python -m venv .venv && source .venv/bin/activate
pip install -e '.[dev]'

# 2. 配置
cp .env.example .env
# 编辑 .env，填入你的 API Key

# 3. 浏览器发布需要
playwright install chromium

# 4. 运行
xhs-skill serve --host 127.0.0.1 --port 8080   # HTTP API
python -m xhs_skill.mcp.server --transport stdio  # MCP

# 搜索热门
xhs-skill search-hot --query "通勤防晒" --provider fixture

# 一键生成
xhs-skill generate --topic "通勤防晒" --search-provider fixture

# 账号分析
xhs-skill account weight --account demo --input examples/account_analytics.json

# 发布流程
xhs-skill publish draft --account demo --package output/package.json
xhs-skill publish preview --draft <draft-id>
xhs-skill publish approve --draft <draft-id>
xhs-skill publish execute --draft <draft-id> --approval-token <token>

{
  "mcpServers": {
    "xhs-skill": {
      "command": "python",
      "args": ["-m", "xhs_skill.mcp.server", "--transport", "stdio"]
    }
  }
}

POST /mcp

GET /.well-known/agent-card.json

pip install -e '.[enterprise]'

├── SKILL.md              # Agent 入口（你正在看的 README 的底层协议）
├── src/xhs_skill/        # Python 源码
│   ├── mcp/              # MCP 协议与 49 个工具
│   ├── research/         # 联网研究与趋势分析
│   ├── generation/       # 内容生成与改写
│   ├── verifiers/        # 合规、原创性、声明校验
│   ├── accounts/         # 账号权重与健康度
│   ├── publishing/       # 授权发布流程
│   ├── operations/       # 发后运营与实验
│   ├── enterprise/       # 企业管控
│   └── ...
├── contracts/            # MCP / OpenAPI / A2A 契约
├── schemas/              # 34 个 JSON Schema
├── references/           # Agent 按需加载的参考文档
├── scripts/              # CLI 与运维脚本
├── tests/                # 测试（unit + contract + integration）
└── evals/                # 1750 条评测数据

pip install -e '.[dev,enterprise,ml,vision]'
pytest
ruff check .
mypy src/xhs_skill scripts