xingzi-mcp

MCP-сервер для Xingzi — позвольте ИИ помогать вам публиковать материалы, проверять отчеты и производить выплаты.

Содержание

• Что такое делегирование материалов

• Рабочий процесс

• Установка и настройка

• Доступные инструменты

• Примеры использования

• Справочник по ценам

• Руководство по составлению требований к задаче

• Техническая архитектура

• Заметки по реверс-инжинирингу API

• FAQ

• Changelog

Related MCP server: commercial-creator

Что такое делегирование материалов

«Делегирование материалов» — это модель продвижения KOC (Key Opinion Consumer):

• Рекламодатель (вы): имеете потребность в продвижении, подготовили материалы (изображения/видео/текст) и готовы платить за результат.

• KOC (инфлюенсер): имеет аккаунты в различных социальных сетях и готов опубликовать контент за вознаграждение.

• Платформа Xingzi: промежуточная платформа, соединяющая обе стороны и предоставляющая возможности для публикации задач, их выполнения, сдачи отчетов и выплат.

Этот MCP-сервер обслуживает роль «Рекламодателя» — публикация задач, проверка отчетов и выплаты вознаграждений KOC.

Рабочий процесс

┌─────────────────────────────────────────────────────────┐
│                    广告主（你 + AI）                       │
│                                                         │
│  ① publish_task ──→ 发布任务（素材+要求+单价+人数）        │
│                         │                                │
│                         ▼                                │
│              KOC 在素材广场看到并领取                       │
│                         │                                │
│                         ▼                                │
│              KOC 发布到社交媒体，提交回执                   │
│                         │                                │
│  ③ list_postbacks ──→ 查看回执                            │
│                         │                                │
│  ④ audit_postback ──→ 审核（通过/拒绝）                    │
│                         │                                │
│  ⑤ pay_reward ──────→ 生成支付链接                        │
│                         │                                │
│                         ▼                                │
│              在微信中打开链接完成付款 ✅                     │
└─────────────────────────────────────────────────────────┘

Установка и настройка

Предварительные требования

• Node.js >= 18

• ИИ-инструмент с поддержкой MCP (Claude Code / Cursor / Windsurf / Cline и др.)

• Аккаунт на платформе Xingzi Zhutui (регистрация: https://m.xingziwenhua.com )

• VIP-статус Xingzi: для публикации задач по материалам требуется статус участника (см. пояснение ниже).

Зачем нужен VIP-статус? Платформа Xingzi Zhutui требует, чтобы только участники могли публиковать задачи по делегированию материалов. Это сделано по двум причинам:

1. Доверие и исполнение: система членства помогает платформе контролировать кредитные риски и риски неисполнения обязательств, гарантируя, что рекламодатель способен вовремя произвести оплату.

2. Преимущества для участников: делегирование материалов само по себе является эксклюзивной услугой для участников платформы.

Если вы еще не являетесь участником, вы можете оформить подписку в «Центре участников» в приложении или H5-версии Xingzi Zhutui.

Claude Code

Отредактируйте ~/.claude/settings.json:

{
  "mcpServers": {
    "xingzi": {
      "command": "npx",
      "args": ["-y", "xingzi-mcp"],
      "env": {
        "XINGZI_MOBILE": "你的手机号",
        "XINGZI_PASSWORD": "你的密码"
      }
    }
  }
}

Cursor

Отредактируйте .cursor/mcp.json:

{
  "mcpServers": {
    "xingzi": {
      "command": "npx",
      "args": ["-y", "xingzi-mcp"],
      "env": {
        "XINGZI_MOBILE": "你的手机号",
        "XINGZI_PASSWORD": "你的密码"
      }
    }
  }
}

Windsurf / Другие

Просто добавьте аналогичную конфигурацию в файл настроек MCP соответствующего инструмента.

Без переменных окружения (ручной вход)

Можно не заполнять поле env. При первом использовании попросите ИИ вызвать инструмент login:

"Помоги мне войти в Xingzi, номер телефона 138xxxx, пароль xxxx"

Доступные инструменты

Всего 11 инструментов, охватывающих полный цикл работы рекламодателя:

Аутентификация и руководство

Публикация задач

Проверка отчетов

Выплаты

Кошелек

Примеры использования

Публикация задачи

你：帮我发一个代发任务
    素材是这张图 https://example.com/ad.jpg
    要求发到小红书，配文提到"夏日好物推荐"
    单价10元，最多50人

AI：[调用 publish_task]
    ✅ 任务发布成功！50 个名额，10 元/条。
    KOC 可以在素材广场看到并领取。

Проверка отчета и выплата

你：看看任务 1615 的回执，合格的帮我通过

AI：[调用 list_postbacks] 共 3 条回执
    - 66°C 提交了抖音链接 ✓
    - 小明 提交了小红书截图 ✓  
    - 用户A 截图模糊看不清 ✗

    [调用 audit_postback x3] 通过 2 条，拒绝 1 条

你：帮我打款

AI：[调用 pay_reward]
    待打款 2 人，共 20 元
    请在微信中打开此链接付款：https://m.xingziwenhua.com/spages/material/batchpay?id=1615
    
    💡 支付页面可以修改金额（表现好的可以加钱），也可以写奖励说明。

Просмотр кошелька

你：钱包余额多少？

AI：[调用 get_wallet]
    总收益：11,290.36 元
    可提现：11,256.46 元
    已提现：33.90 元
    冻结中：0.00 元

Справочник по ценам

Задачи с ценой ниже 5 юаней имеют крайне низкий уровень принятия, MCP будет активно предупреждать вас об этом.

Руководство по составлению требований к задаче

Требования к задаче (task_requirement) являются ключевым фактором, влияющим на уровень принятия и качество выполнения.

Пример хороших требований

发布到小红书，图文形式。
配文需包含"XXX品牌夏日新品"关键词，200字以内。
发布后截图+笔记链接作为回执。

发布到抖音，直接使用我提供的视频素材。
视频标题和文案自由发挥，需要 @XXX品牌 官方账号。
发布后提交视频链接。

Рекомендуется включить

• Платформу (Xiaohongshu / Douyin / Zhihu / Weibo и т.д.)

• Формат (текст с фото / видео / статья)

• Основные тезисы (название бренда, ключевые слова, хэштеги и т.д.)

• Требования по времени публикации (если есть)

Рекомендуется избегать

• ❌ Требования публиковать на нескольких платформах одновременно (лучше разбить на разные задачи)

• ❌ Ограничений по количеству подписчиков (если только вы не готовы значительно повысить цену)

• ❌ Требований к оригинальным длинным видео (высокая сложность, низкий уровень выполнения)

• ❌ Требований закрепить/добавить в избранное/попасть в топ (неконтролируемые факторы)

• ❌ Слишком длинных и сложных описаний (KOC просто уйдут)

Техническая архитектура

Общий дизайн

┌──────────────────┐     stdio      ┌───────────────────┐
│  AI 工具          │ ◄──────────► │  xingzi-mcp       │
│  (Claude/Cursor)  │   MCP协议     │  (Node.js Server) │
└──────────────────┘               └─────────┬─────────┘
                                             │ HTTPS
                                             ▼
                                   ┌───────────────────┐
                                   │  api.xingziwenhua  │
                                   │  .com              │
                                   │  (星子助推后端)      │
                                   └───────────────────┘

Технологический стек

• Среда выполнения: Node.js >= 18 (используется нативный fetch)

• MCP SDK: @modelcontextprotocol/sdk

• Валидация параметров: zod (встроенная зависимость MCP SDK)

• Протокол передачи: stdio (стандартный ввод-вывод)

• API: HTTPS REST, формат JSON

Механизм аутентификации

Xingzi API использует нестандартный метод аутентификации (обнаружен путем реверс-инжиниринга H5-приложения):

// 不是标准的 Authorization: Bearer <token>
// 而是三个自定义 HTTP headers:
headers: {
  "token": "<JWT>",      // 登录返回的 token
  "plt": "h5",           // 平台标识，固定值
  "user_id": "<number>"  // 用户 ID
}

Срок действия токена — 24 часа, MCP автоматически выполнит повторный вход до истечения срока.

Обработка сумм

Внутри API используются фэни (1 юань = 100 фэней). Инструменты MCP используют юани, конвертация происходит автоматически.

Процесс оплаты

Выплаты осуществляются через WeChat JSAPI, что требует среды браузера WeChat (WeixinJSBridge). MCP не может напрямую инициировать оплату, поэтому генерируется URL страницы оплаты:

https://m.xingziwenhua.com/spages/material/batchpay?id={task_id}
https://m.xingziwenhua.com/spages/material/batchpay?id={task_id}&to_user_id={koc_id}

Пользователь может завершить оплату, открыв ссылку в WeChat. Страница оплаты поддерживает изменение суммы и добавление описания вознаграждения.

Заметки по реверс-инжинирингу API

Все API-эндпоинты этого MCP были получены путем реверс-инжиниринга H5-приложения Xingzi Zhutui (m.xingziwenhua.com), официальная документация API отсутствует.

Метод реверс-инжиниринга

1. Puppeteer для имитации мобильного браузера и входа в H5-приложение.

2. Перехват XHR-запросов для наблюдения за вызовами API (используются кастомные заголовки, а не стандартный Bearer).

3. Анализ webpack chunk JS для извлечения всех путей API.

4. Поочередное тестирование эндпоинтов для подтверждения параметров и форматов ответа.

Ключевые находки

Проверенные API-эндпоинты

POST /c/user/login                               — 手机号+密码登录
GET  /c/user/detail                              — 用户信息
GET  /c/channel/list-available                   — 可用推广频道
POST /c/fodder/material/instead/publish           — 发布素材任务
GET  /c/fodder/material/instead/list              — 素材列表
GET  /c/fodder/material/instead/materialInfo      — 素材详情
POST /c/fodder/material/instead/del               — 删除素材
GET  /c/fodder/material/instead/postback/list     — 回执列表
POST /c/fodder/material/instead/postbackAudit     — 审核回执
GET  /c/fodder/material/instead/unpaidAward/list  — 待打款列表
POST /c/fodder/material/instead/batch/pay/reward  — 批量打款 (需微信)
GET  /c/withdraw/wallet                          — 钱包余额

Коды статуса отчета (status)

FAQ

Q: Как загрузить файлы материалов?

publish_task в MCP принимает URL файла (публично доступную ссылку), а не путь к локальному файлу. Вам нужно сначала загрузить файл на любой хостинг (Tencent Cloud COS, Alibaba OSS, Qiniu или даже GitHub), а затем передать URL в MCP.

Q: Почему выплаты нельзя завершить прямо в MCP?

Выплаты Xingzi осуществляются через WeChat JSAPI, что требует вызова WeixinJSBridge.invoke('getBrandWCPayRequest', ...) внутри браузера WeChat. Это техническое ограничение WeChat Pay, а не MCP. MCP генерирует ссылку, которую вы открываете в WeChat для оплаты.

Q: Можно ли прикрепить несколько файлов к одной задаче?

Да. Параметр files — это массив, поддерживающий до 50 файлов. Поддерживаемые форматы: gif, jpg, jpeg, png, word, txt, pdf, mp4.

Q: Что происходит с материалом после отклонения отчета?

После отклонения квота KOC освобождается, и другие KOC могут взять задачу. Если вы указали причину отклонения (reject_reason), KOC ее увидит.

Q: Что делать, если токен истек?

Ничего. MCP автоматически выполнит повторный вход с вашими учетными данными до истечения срока действия токена (24 часа).

Q: Можно ли использовать несколько аккаунтов одновременно?

Один экземпляр MCP соответствует одному аккаунту. Если нужно несколько, добавьте несколько серверов в конфигурацию MCP с разными именами:

{
  "mcpServers": {
    "xingzi-account1": {
      "command": "npx",
      "args": ["-y", "xingzi-mcp"],
      "env": { "XINGZI_MOBILE": "手机号1", "XINGZI_PASSWORD": "密码1" }
    },
    "xingzi-account2": {
      "command": "npx",
      "args": ["-y", "xingzi-mcp"],
      "env": { "XINGZI_MOBILE": "手机号2", "XINGZI_PASSWORD": "密码2" }
    }
  }
}

Q: Какую цену лучше установить?

Зависит от сложности. Минимум 5 юаней, ниже этой суммы задачу почти никто не возьмет. Подробнее см. Справочник по ценам.

Q: Можно ли изменить сумму на странице оплаты?

Да. После открытия ссылки, сгенерированной pay_reward, сумму для каждого KOC можно изменить вручную. Также можно добавить «описание вознаграждения», которое увидит KOC.

Q: Какова связь между этим MCP и приложением Xingzi Zhutui?

Xingzi Zhutui — это полноценная платформа продвижения KOC. «Делегирование материалов» — это один из независимых продуктов. Данный MCP инкапсулирует только операции рекламодателя для этого продукта и не включает другие функции (ключевые слова, управление командой, статистика доходов и т.д.).

Q: Это безопасно? Где хранятся логин и пароль?

• Переменные окружения: пароль хранится в вашем локальном файле конфигурации MCP и не передается никуда, кроме API Xingzi.

• Ручной вход: пароль используется только в текущей сессии.

• Код MCP полностью открыт, вы можете провести аудит самостоятельно.

Changelog

3.0.0 (2026-04-06)

• Полная проверка сквозного процесса.

• Очистка кода и документации.

• Публикация на GitHub.

2.1.0

• pay_reward поддерживает выплаты одному/всем, добавлен параметр koc_user_id.

• Ссылки на оплату поддерживают фильтрацию по to_user_id.

2.0.1

• Исправлен параметр audit_postback: is_pass (не isPass), claim_id + postback_id (не material_id + id).

2.0.0

• Рефакторинг под делегирование материалов, удаление лишних функций.

• Сокращение инструментов с 21 до 11.

• Оптимизация значений по умолчанию.

• Единица суммы изменена с «фэней» на «юани».

• Добавлен инструмент guide.

1.0.0

• Начальная версия, полная инкапсуляция API Xingzi Zhutui.

License

MIT