Skip to main content
Glama
yylwdyx-commits

xingzi-mcp

xingzi-mcp

星子代発 MCP Server — AIが素材の配布、提出物の審査、報酬の支払いを代行します。

npm version

目次


Related MCP server: commercial-creator

素材代発とは

「素材代発」は、KOC (Key Opinion Consumer) プロモーションモデルの一種です:

  • 広告主(あなた):プロモーションのニーズがあり、素材(画像/動画/コピー)を用意し、成果報酬型で支払う意欲がある

  • KOC(インフルエンサー):各SNSプラットフォームでアカウントを持ち、コンテンツを投稿して報酬を得る意欲がある

  • 星子代発プラットフォーム:両者を繋ぐ仲介プラットフォームで、タスクの公開、受領、提出物確認、支払い機能を提供

このMCPは「広告主」の役割をサポートします——タスクの公開、提出物の審査、KOCへの支払いを行います。

ワークフロー

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

インストールと設定

前提条件

  • Node.js >= 18

  • MCPをサポートするAIツール(Claude Code / Cursor / Windsurf / Clineなど)

  • 星子助推プラットフォームのアカウント(登録:https://m.xingziwenhua.com )

  • 星子会員(VIP):素材代発タスクの公開には会員資格が必要です(下記説明を参照)

なぜ会員が必要なのですか? 星子助推プラットフォームでは、素材代発タスクを公開できるのは会員のみです。これには2つの理由があります:

  1. 信用と履行:会員システムにより、プラットフォームは信用リスクと不履行リスクを管理し、広告主が期限内に支払えることを保証します

  2. 会員特典:素材代発自体が、プラットフォームが会員に提供する専用の付加価値サービスです

まだ会員でない場合は、星子助推アプリ/H5の「会員センター」から登録できます。

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 フィールドを空欄にすることも可能です。初回使用時にAIに login ツールを呼び出させてください:

「星子代発にログインして。電話番号は138xxxx、パスワードはxxxx」

利用可能なツール

合計 11個 のツールがあり、広告主の全操作フローをカバーしています:

認証とガイド

ツール

説明

login

プラットフォームにログイン(環境変数が設定されていれば自動ログイン)

guide

使用ガイドと価格設定の目安を確認

タスクの公開

ツール

説明

publish_task

コア:代発タスクを公開(素材+要件+単価+人数)

list_my_tasks

公開したすべてのタスクを確認

get_task_detail

特定のタスクの詳細を確認

delete_task

タスクを削除

提出物の審査

ツール

説明

list_postbacks

KOCが提出した回執(作品リンク/スクリーンショット)を確認

audit_postback

提出物の審査:承認または拒否

支払い

ツール

説明

list_unpaid_awards

未払いリストを確認

pay_reward

WeChat支払いリンクを生成(全選択/単一選択/金額変更に対応)

ウォレット

ツール

説明

get_wallet

残高を確認(総収益/出金可能額/出金済み/凍結中)

使用例

代発タスクの公開

你:帮我发一个代发任务
    素材是这张图 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-8 元

素材をそのまま転送し、簡単なコメントを添える

画像・テキスト

8-15 元

KOCに短い文章を作成してもらう

ショート動画

15-30 元

KOCに動画の撮影/編集を依頼する

5元/件未満のタスクは受領率が極めて低いため、MCPが自動的に警告します。

タスク要件の作成ガイド

タスク要件(task_requirement)は、受領率と完成度に大きく影響します。

良いタスク要件の例

发布到小红书,图文形式。
配文需包含"XXX品牌夏日新品"关键词,200字以内。
发布后截图+笔记链接作为回执。
发布到抖音,直接使用我提供的视频素材。
视频标题和文案自由发挥,需要 @XXX品牌 官方账号。
发布后提交视频链接。

記載すべき内容

  • 投稿先プラットフォーム(小紅書 / 抖音 / 知乎 / 微博など)

  • 形式(画像・テキスト / 動画 / 記事)

  • コピーの核心ポイント(ブランド名、キーワード、ハッシュタグなど)

  • 投稿時間の指定(もしあれば)

避けるべき内容

  • ❌ 複数のプラットフォームへの投稿を同時に要求する(タスクを分けた方が良い)

  • ❌ フォロワー数を制限する(単価を大幅に上げない限り)

  • ❌ オリジナルの長尺動画を要求する(複雑度が高く、完了率が低い)

  • ❌ トップ固定/おすすめ表示/トレンド入りを要求する(制御不能な要素)

  • ❌ タスク説明が長すぎる/複雑すぎる(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形式

認証メカニズム

星子APIは非標準的な認証方式を使用しています(H5アプリのリバースエンジニアリングにより判明):

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

トークンの有効期限は24時間で、MCPは期限切れ前に自動的に再ログインします。

金額の処理

API内部では金額単位として**「分」を使用します(例:500 = 5.00元)。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リバースエンジニアリングメモ

本MCPのすべてのAPIエンドポイントは、星子助推H5アプリ (m.xingziwenhua.com) のリバースエンジニアリングを通じて取得したものであり、プラットフォーム側から公開APIドキュメントは提供されていません。

リバースエンジニアリング手法

  1. Puppeteerでモバイルブラウザをシミュレートし、H5アプリにログイン

  2. XHRリクエストをインターセプトし、API呼び出しを観察(標準のBearer認証ではなくカスタムヘッダーを使用)

  3. webpack chunk JSを解析し、すべてのAPIパスを抽出

  4. 各エンドポイントをテストし、パラメータと戻り値の形式を確認

主要な発見

発見

詳細

認証方式

カスタムヘッダー token + plt + user_id を使用。Authorization: Bearer ではない

審査APIパラメータ

フィールド名は is_pass(アンダースコア)、isPass(キャメルケース)ではない(Java Springのデシリアライズ要件)

金額単位

「分」、1元 = 100

支払い制限

WeChat JSAPIが必須。純粋なAPIのみでは完了不可

チャンネルID

星子代発 = 188

ファイルアップロード

フロントエンドからCOSへ直接アップロード。API層はアップロード済みのURLのみ受け付け

検証済み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)

値

意味

1

受領済み、提出物未提出

2

提出済み、審査待ち

3

審査承認

FAQ

Q: 素材ファイルはどうやってアップロードしますか?

MCPの publish_task はファイルURL(公開アクセス可能なリンク)を受け取ります。ローカルファイルパスではありません。ファイルを任意のファイルホスティングサービス(Tencent Cloud COS、Aliyun OSS、七牛、GitHubなど)にアップロードし、そのURLをMCPに渡してください。

星子H5アプリ自体はフロントエンドからTencent Cloud COSへ直接アップロードしていますが、アップロードインターフェースはフロントエンドSDKにバインドされており、純粋なAPI呼び出しでは利用できません。

Q: なぜ支払いはMCP内で直接完了できないのですか?

星子の支払いはWeChat JSAPI決済を利用しており、WeChatブラウザ内で WeixinJSBridge.invoke('getBrandWCPayRequest', ...) を呼び出す必要があります。これはWeChat Payの技術的な制限であり、MCPの制限ではありません。MCPは支払いページのリンクを生成し、それをWeChatで開くことで支払えます。

Q: 1つのタスクで複数の素材ファイルを送信できますか?

はい。files パラメータは配列であり、最大50個までのURLをサポートしています。対応形式:gif、jpg、jpeg、png、word、txt、pdf、mp4。

Q: 審査で拒否された場合、素材はどうなりますか?

拒否されると、そのKOCの受領枠が解放され、他のKOCが再度受領できるようになります。拒否理由(reject_reason)を入力した場合、KOCもそれを確認できます。

Q: トークンが期限切れになったらどうすればいいですか?

何もしなくて大丈夫です。MCPはトークン期限切れ前に、アカウントとパスワードを使用して自動的に再ログインします。トークンの有効期限は24時間です。

Q: 複数のアカウントを同時に使用できますか?

1つのMCPインスタンスは1つのアカウントに対応しています。複数のアカウントが必要な場合は、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元を推奨します。5元未満だとほとんど誰も受領しません。詳細は 価格設定の目安 を参照してください。

Q: 支払いページで金額を変更できますか?

はい。pay_reward で生成されたリンクを開くと、各KOCの金額を手動で変更できます。例えば、特定のKOCの品質が非常に高い場合、多めに支払うことができます。「報酬説明」を入力することもでき、KOCも確認可能です。

Q: このMCPと星子助推アプリの関係は?

星子助推は、ツイート、ショートドラマ、小説など多様なプロモーション業務を含む総合的なKOCプロモーションプラットフォームです。「素材代発」はその中の独立した製品モジュールです。本MCPは素材代発の広告主操作のみをカプセル化しており、星子助推の他の機能(キーワード、チーム管理、収益統計など)は含まれていません。

Q: 安全ですか?アカウントとパスワードはどこに保存されますか?

  • 環境変数方式:パスワードはローカルのMCP設定ファイルに保存され、星子API以外には送信されません

  • 手動ログイン方式:パスワードは現在のセッションでのみ使用されます

  • 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カプセル化を含む

License

MIT

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to manage and publish content across multiple Chinese social media platforms including Xiaohongshu, Douyin, WeChat, Weibo, Zhihu, and Bilibili.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to produce video commercials from product descriptions via a multi-stage pipeline with human-in-the-loop approval gates and explicit spend authorization.
    5
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to perform marketing operations like campaign management, content creation, and outreach, with a tiered approval model ensuring human oversight for consequential actions.
    MIT