xingzi-mcp

Xingzi-Agentur-MCP-Server — Lassen Sie die KI für Sie Materialien veröffentlichen, Belege prüfen und Zahlungen tätigen.

Inhaltsverzeichnis

• Was ist die Material-Agentur-Veröffentlichung?

• Arbeitsablauf

• Installation und Konfiguration

• Verfügbare Tools

• Anwendungsbeispiele

• Preisreferenz

• Leitfaden für Aufgabenanforderungen

• Technische Architektur

• Notizen zum API-Reverse-Engineering

• FAQ

• Changelog

Was ist die Material-Agentur-Veröffentlichung?

„Material-Agentur-Veröffentlichung“ ist ein KOC (Key Opinion Consumer) Werbemodell:

• Werbetreibender (Sie): Hat Werbebedarf, bereitet Materialien (Bilder/Videos/Texte) vor und ist bereit, nach Erfolg zu bezahlen.

• KOC (Influencer): Hat Konten auf verschiedenen sozialen Plattformen und ist bereit, Inhalte für Sie zu veröffentlichen, um Belohnungen zu verdienen.

• Xingzi-Agentur-Plattform: Die Zwischenplattform, die beide Seiten verbindet und Funktionen für Aufgabenveröffentlichung, Annahme, Belegprüfung und Zahlungsabwicklung bereitstellt.

Dieser MCP-Dienst bedient die Rolle des „Werbetreibenden“ – Aufgaben veröffentlichen, Belege prüfen und KOCs bezahlen.

Arbeitsablauf

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

Installation und Konfiguration

Voraussetzungen

• Node.js >= 18

• Ein KI-Tool, das MCP unterstützt (Claude Code / Cursor / Windsurf / Cline usw.)

• Ein Konto auf der Xingzi-Boost-Plattform (Registrierung: https://m.xingziwenhua.com )

• Xingzi-Mitgliedschaft (VIP): Für die Veröffentlichung von Materialaufgaben ist eine Mitgliedschaft erforderlich (siehe Erläuterung unten).

Warum ist eine Mitgliedschaft erforderlich? Die Xingzi-Boost-Plattform verlangt, dass nur Mitglieder Material-Agentur-Aufgaben veröffentlichen können. Dies geschieht aus zwei Gründen:

1. Glaubwürdigkeit und Vertragserfüllung: Das Mitgliedschaftssystem hilft der Plattform, Kreditrisiken und Ausfallrisiken zu kontrollieren und sicherzustellen, dass Werbetreibende in der Lage sind, pünktlich zu zahlen.

2. Mitgliedervorteile: Die Material-Agentur-Veröffentlichung selbst ist ein exklusiver Mehrwertdienst der Plattform für Mitglieder.

Wenn Sie noch kein Mitglied sind, können Sie dies im „Mitgliederzentrum“ der Xingzi-Boost App / H5 aktivieren.

Claude Code

Bearbeiten Sie ~/.claude/settings.json:

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

Cursor

Bearbeiten Sie .cursor/mcp.json:

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

Windsurf / Andere

Fügen Sie einfach die gleiche Konfiguration in die MCP-Konfigurationsdatei des entsprechenden Tools ein.

Ohne Umgebungsvariablen (Manuelle Anmeldung)

Sie können das Feld env auch leer lassen. Lassen Sie die KI bei der ersten Verwendung das Tool login aufrufen:

„Hilf mir, mich bei der Xingzi-Agentur anzumelden, Handynummer 138xxxx, Passwort xxxx“

Verfügbare Tools

Insgesamt 11 Tools, die den vollständigen Betriebsprozess für Werbetreibende abdecken:

Authentifizierung und Anleitung

Aufgaben veröffentlichen

Belege prüfen

Zahlungen

Geldbörse

Anwendungsbeispiele

Eine Agentur-Aufgabe veröffentlichen

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

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

Belege prüfen und bezahlen

你：看看任务 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
    
    💡 支付页面可以修改金额（表现好的可以加钱），也可以写奖励说明。

Geldbörse anzeigen

你：钱包余额多少？

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

Preisreferenz

Aufgaben unter 5 Yuan/Stück haben eine extrem niedrige Annahmequote, der MCP wird Sie proaktiv darauf hinweisen.

Leitfaden für Aufgabenanforderungen

Die Aufgabenanforderungen (task_requirement) sind entscheidend für die Annahmequote und die Qualität der Erledigung.

Beispiel für gute Aufgabenanforderungen

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

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

Empfohlene Inhalte

• Auf welcher Plattform (Xiaohongshu / Douyin / Zhihu / Weibo usw.)

• Welches Format (Bild/Text / Video / Artikel)

• Kernpunkte des Textes (Markenname, Keywords, Hashtags usw.)

• Anforderungen an die Veröffentlichungszeit (falls vorhanden)

Zu vermeiden

• ❌ Gleichzeitige Anforderung für mehrere Plattformen (besser in mehrere Aufgaben aufteilen)

• ❌ Begrenzung der Followerzahl (es sei denn, Sie sind bereit, den Stückpreis deutlich zu erhöhen)

• ❌ Anforderung von originellen langen Videos (hohe Komplexität, niedrige Abschlussrate)

• ❌ Anforderung von „Anpinnen/Hervorheben/Trend-Status“ (unkontrollierbare Faktoren)

• ❌ Aufgabenbeschreibung zu lang oder zu komplex (KOCs springen sofort ab)

Technische Architektur

Gesamtdesign

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

Tech-Stack

• Laufzeit: Node.js >= 18 (unter Verwendung von nativem fetch)

• MCP SDK: @modelcontextprotocol/sdk

• Parameter-Validierung: zod (eingebaute Abhängigkeit des MCP SDK)

• Übertragungsprotokoll: stdio (Standard Input/Output)

• API-Kommunikation: HTTPS REST, JSON-Format

Authentifizierungsmechanismus

Xingzi API verwendet eine nicht standardmäßige Authentifizierungsmethode (entdeckt durch Reverse Engineering der H5-App):

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

Das Token ist 24 Stunden gültig; der MCP meldet sich automatisch neu an, bevor es abläuft.

Umgang mit Geldbeträgen

Die API verwendet intern Cent als Geldeinheit (z. B. 500 = 5,00 Yuan). Die MCP-Tools verwenden einheitlich Yuan und konvertieren intern automatisch.

Zahlungsprozess

Die Zahlung erfolgt über WeChat JSAPI-Zahlung, was eine WeChat-Browserumgebung (WeixinJSBridge) erfordert. Der MCP kann die Zahlung nicht direkt auslösen, sondern generiert stattdessen eine URL zur Zahlungsseite:

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}

Der Benutzer kann die Zahlung abschließen, indem er die Seite in WeChat öffnet. Die Zahlungsseite unterstützt die Änderung des Betrags und das Ausfüllen von Belohnungshinweisen.

Notizen zum API-Reverse-Engineering

Alle API-Endpunkte dieses MCP wurden durch Reverse Engineering der Xingzi-Boost H5-App (m.xingziwenhua.com) gewonnen; die Plattform bietet keine öffentliche API-Dokumentation.

Reverse-Engineering-Methoden

1. Puppeteer zur Simulation eines mobilen Browsers für die Anmeldung in der H5-App

2. Abfangen von XHR-Anfragen zur Beobachtung von API-Aufrufen (benutzerdefinierte Header statt Standard-Bearer-Authentifizierung)

3. Analyse von Webpack-Chunk-JS, um alle API-Pfade zu extrahieren

4. Testen der Endpunkte einzeln, um Parameter und Rückgabeformate zu bestätigen

Wichtige Erkenntnisse

Verifizierte API-Endpunkte

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                          — 钱包余额

Beleg-Statuscodes (status)

FAQ

F: Wie werden Materialdateien hochgeladen?

Der publish_task des MCP akzeptiert eine Datei-URL (öffentlich zugänglicher Link), keinen lokalen Dateipfad. Sie müssen die Datei zuerst auf einen beliebigen Datei-Hosting-Dienst hochladen (z. B. Tencent Cloud COS, Alibaba Cloud OSS, Qiniu oder sogar GitHub) und dann die URL an den MCP übergeben.

Die Xingzi H5-App selbst nutzt den direkten Frontend-Upload zu Tencent Cloud COS, aber die Upload-Schnittstelle ist an das Frontend-SDK gebunden und kann nicht über eine reine API aufgerufen werden.

F: Warum kann die Zahlung nicht direkt im MCP abgeschlossen werden?

Die Zahlung bei Xingzi erfolgt über WeChat JSAPI, was den Aufruf von WeixinJSBridge.invoke('getBrandWCPayRequest', ...) innerhalb des WeChat-Browsers erfordert. Dies ist eine technische Einschränkung von WeChat Pay, keine Einschränkung des MCP. Der MCP generiert einen Link zur Zahlungsseite, den Sie in WeChat öffnen können, um zu bezahlen.

F: Kann eine Aufgabe mehrere Materialdateien enthalten?

Ja. Der Parameter files ist ein Array und unterstützt mehrere URLs, bis zu 50 Dateien. Unterstützte Formate: gif, jpg, jpeg, png, word, txt, pdf, mp4.

F: Was passiert mit dem Material, wenn die Prüfung abgelehnt wird?

Nach der Ablehnung wird der Annahmeplatz für diesen KOC freigegeben und andere KOCs können die Aufgabe weiterhin annehmen. Wenn Sie einen Ablehnungsgrund (reject_reason) angegeben haben, kann der KOC diesen ebenfalls sehen.

F: Was passiert, wenn das Token abgelaufen ist?

Kein Problem. Der MCP meldet sich automatisch mit Ihrem Benutzernamen und Passwort neu an, bevor das Token abläuft. Das Token ist 24 Stunden gültig.

F: Kann ich mehrere Konten gleichzeitig verwenden?

Eine MCP-Instanz entspricht einem Konto. Wenn Sie mehrere Konten benötigen, können Sie in der MCP-Konfiguration mehrere Server hinzufügen und diese mit unterschiedlichen Namen unterscheiden:

{
  "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" }
    }
  }
}

F: Welcher Stückpreis ist angemessen?

Das hängt von der Komplexität der Aufgabe ab. Mindestens 5 Yuan empfohlen; unter 5 Yuan nimmt es fast niemand an. Siehe Preisreferenz.

F: Kann der Betrag auf der Zahlungsseite geändert werden?

Ja. Nachdem der von pay_reward generierte Link geöffnet wurde, kann der Betrag für jeden KOC manuell geändert werden. Wenn ein KOC beispielsweise besonders gute Arbeit geleistet hat, können Sie ihm mehr bezahlen. Sie können auch einen „Belohnungshinweis“ ausfüllen, den der KOC sehen kann.

F: In welcher Beziehung steht dieser MCP zur Xingzi-Boost App?

Xingzi-Boost ist eine vollständige KOC-Werbeplattform, die verschiedene Werbegeschäfte wie Tweets, Kurzfilme, Romane usw. umfasst. „Material-Agentur-Veröffentlichung“ ist ein eigenständiges Produktmodul. Dieser MCP kapselt nur die Operationen für Werbetreibende der Material-Agentur-Veröffentlichung und enthält keine anderen Funktionen von Xingzi-Boost (Keywords, Teamverwaltung, Ertragsstatistik usw.).

F: Ist es sicher? Wo werden Benutzername und Passwort gespeichert?

• Umgebungsvariablen-Methode: Das Passwort wird in Ihrer lokalen MCP-Konfigurationsdatei gespeichert und nirgendwo anders als an die Xingzi-API übertragen.

• Manuelle Anmeldemethode: Das Passwort wird nur während der aktuellen Sitzung verwendet.

• Der MCP-Code ist vollständig Open Source und kann selbst geprüft werden.

Changelog

3.0.0 (2026-04-06)

• Vollständige End-to-End-Prozessvalidierung bestanden

• Code und Dokumentation umfassend bereinigt

• Veröffentlichung auf GitHub

2.1.0

• pay_reward unterstützt Einzel-/Mehrfachzahlung, unterstützt koc_user_id-Parameter

• Zahlungslink unterstützt to_user_id-Filterung

2.0.1

• Korrektur des audit_postback-Parameters: is_pass (nicht isPass), claim_id + postback_id (nicht material_id + id)

2.0.0

• Umstrukturierung für die Material-Agentur-Veröffentlichung, Entfernung irrelevanter Funktionen von Xingzi-Boost

• Tools von 21 auf 11 reduziert

• Standardwert-Optimierung: Kanal fest auf Xingzi-Agentur, Standardmaterial, fester Stückpreis, öffentlich sichtbar

• Geldeinheit von „Cent“ auf „Yuan“ geändert

• Neues guide-Tool für Benutzeranleitungen hinzugefügt

1.0.0

• Erste Version, enthält die vollständige Kapselung der Xingzi-Boost-API

Lizenz

MIT