xingzi-mcp
xingzi-mcp
星子代発 MCP Server — AIが素材の配布、提出物の審査、報酬の支払いを代行します。
目次
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つの理由があります:
信用と履行:会員システムにより、プラットフォームは信用リスクと不履行リスクを管理し、広告主が期限内に支払えることを保証します
会員特典:素材代発自体が、プラットフォームが会員に提供する専用の付加価値サービスです
まだ会員でない場合は、星子助推アプリ/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個 のツールがあり、広告主の全操作フローをカバーしています:
認証とガイド
ツール | 説明 |
| プラットフォームにログイン(環境変数が設定されていれば自動ログイン) |
| 使用ガイドと価格設定の目安を確認 |
タスクの公開
ツール | 説明 |
| コア:代発タスクを公開(素材+要件+単価+人数) |
| 公開したすべてのタスクを確認 |
| 特定のタスクの詳細を確認 |
| タスクを削除 |
提出物の審査
ツール | 説明 |
| KOCが提出した回執(作品リンク/スクリーンショット)を確認 |
| 提出物の審査:承認または拒否 |
支払い
ツール | 説明 |
| 未払いリストを確認 |
| WeChat支払いリンクを生成(全選択/単一選択/金額変更に対応) |
ウォレット
ツール | 説明 |
| 残高を確認(総収益/出金可能額/出金済み/凍結中) |
使用例
代発タスクの公開
你:帮我发一个代发任务
素材是这张图 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ドキュメントは提供されていません。
リバースエンジニアリング手法
Puppeteerでモバイルブラウザをシミュレートし、H5アプリにログイン
XHRリクエストをインターセプトし、API呼び出しを観察(標準のBearer認証ではなくカスタムヘッダーを使用)
webpack chunk JSを解析し、すべてのAPIパスを抽出
各エンドポイントをテストし、パラメータと戻り値の形式を確認
主要な発見
発見 | 詳細 |
認証方式 | カスタムヘッダー |
審査APIパラメータ | フィールド名は |
金額単位 | 「分」、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
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage 230M+ influencers, track campaigns, and access real-time CIMS analytics via AI agents
AI agents that manage paid ads on Meta, LinkedIn, and Google Ads from any MCP client.
AI agents hire verified human creators to post on real social accounts.
Create, manage, schedule, and publish short-form user-generated content through AI agents.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to manage and publish content across multiple Chinese social media platforms including Xiaohongshu, Douyin, WeChat, Weibo, Zhihu, and Bilibili.-
- AlicenseNot gradedqualityDmaintenanceEnables 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.5MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to automate social media content generation, approval, and publishing, along with blog management, SEO/GEO audits, and ad operations through natural language.3AGPL 3.0