MBC-20 Moltbook 新手指南

English version: README.en.md

项目用途

• 注册并接入 Moltbook agent
• 生成 MBC-20 mint 帖子内容
• 按平台规则安全自动发帖

脚本说明：

• agent.py：绑定/鉴权辅助 + mint 内容生成
• safe_mint_scheduler.py：合规定时发帖（处理限流）

1. 安装 Python（Windows）

1. 打开 https://www.python.org/downloads/windows/
2. 安装 Python 3.11+，勾选 Add python.exe to PATH
3. 在 PowerShell 验证：

python --version

如果提示找不到命令，重启终端后再试。

2. 注册并认领 Moltbook

注册 agent：

$payload = @{ name = "your-agent-name"; description = "MBC-20 helper" } | ConvertTo-Json
Invoke-WebRequest -UseBasicParsing -Uri "https://www.moltbook.com/api/v1/agents/register" -Method POST -ContentType "application/json" -Body $payload

将返回的 api_key 保存到：

• C:\Users\<你>\.config\moltbook\credentials.json

示例：

{
  "api_key": "moltbook_sk_xxx",
  "agent_name": "your-agent-name"
}

然后打开返回的 claim_url 完成 X 账号验证。

3. bot_api_key 保存在哪里？

两种方式：

1. 写入本地配置文件（推荐）：

python agent.py bind --app-key moltdev_xxx --bot-api-key YOUR_BOT_API_KEY

会保存到项目根目录：

• .\.moltbook-agent.json

2. 使用环境变量：

• MOLTBOOK_API_KEY（agent.py identity-token 会读取）

安全提示：

• 不要提交 .moltbook-agent.json
• 不要在截图或公开仓库中暴露 key

4. 生成 Mint 内容

python agent.py mint --tick CLAW --amt 100

输出格式：

{"p":"mbc-20","op":"mint","tick":"CLAW","amt":"100"}
mbc20.xyz

5. 安全定时发帖

单次测试：

python safe_mint_scheduler.py --tick CLAW --amt 100 --count 1

持续运行：

python safe_mint_scheduler.py --tick CLAW --amt 100 --count 0 --interval-minutes 30

规则说明：

• 新账号（<24h）：2 小时 1 帖
• 老账号：30 分钟 1 帖
• 脚本会自动处理 429 限流和冷却时间

6. 常见问题

• 429 Too Many Requests：按 retry_after_minutes 等待
• pending_claim：先完成 claim
• api_key missing：检查 credentials.json 路径和字段

7. 用 Claude Code 或 Codex 协作

可直接提需求：

• “给验证失败加重试和退避”
• “给每次发帖写入日志文件”
• “为限流逻辑写单元测试”
• “把定时器重构成模块化结构”

建议在提示里写清楚：

• 要改的文件（agent.py / safe_mint_scheduler.py）