Browserman

简体中文

English

简体中文

English

Appearance

入门指南 ​

欢迎使用 Browserman！本指南将帮助你在几分钟内开始使用浏览器自动化。

什么是 Browserman？ ​

Browserman 是一个浏览器自动化平台，允许你：

  • 自动化社交媒体 - 在多个平台上发布、互动和管理内容
  • 管理多个账号 - 在一个地方安全地处理数十个账号
  • 与 AI 集成 - 通过模型上下文协议（MCP）与 Claude、ChatGPT 配合使用
  • 规模化操作 - 从每天几个任务到数千个任务

3 步快速开始 ​

1. 创建账号 ​

访问 app.browserman.run 并注册：

  1. 点击注册
  2. 输入你的邮箱和密码
  3. 验证你的邮箱
  4. 登录控制台

2. 连接你的第一个账号 ​

绑定社交媒体账号开始自动化：

  1. 在侧边栏点击账号
  2. 点击添加账号
  3. 选择平台（Twitter、雪球等）
  4. 上传 cookies 文件
  5. 给账号起个名字

3. 发起你的第一个请求 ​

选择你喜欢的方式：

选项 A：使用控制台 ​

  1. 前往任务 > 新建任务
  2. 选择你的账号
  3. 选择操作（例如"发布推文"）
  4. 填写参数
  5. 点击执行

选项 B：使用 API ​

bash
curl -X POST https://api.browserman.run/api/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "twitter",
    "tool": "createTweet",
    "accountName": "my-account",
    "parameters": {
      "text": "来自 Browserman 的问候！🚀"
    }
  }'

选项 C：使用 Claude（MCP） ​

  1. 配置 MCP
  2. 打开 Claude Desktop
  3. 说："使用我的账号发布一条推文：'来自 Browserman 的问候！'"

核心概念 ​

平台 ​

Browserman 支持多个平台：

  • Twitter/X
  • 雪球
  • 东方财富
  • 同花顺

每个平台都有特定的工具（操作）可以执行。

账号 ​

账号是你连接的社交媒体配置文件。关键点：

  • 每个账号都有唯一的名称
  • 一个平台可以有多个账号
  • 账号被加密存储

工具 ​

工具是你可以在平台上执行的操作：

  • createTweet - 发布推文
  • likeTweet - 点赞推文
  • xueqiu_post - 发布到雪球
  • 还有更多...

查看所有可用工具：API 参考

任务 ​

任务是单个自动化作业：

  • 每个 API 调用创建一个任务
  • 任务有状态：pending（待处理）、processing（处理中）、completed（已完成）、failed（失败）
  • 你可以跟踪任务状态和结果

执行引擎 ​

Browserman 提供两种执行模式：

轻量模式（默认）

  • 快速高效
  • 资源占用低
  • 适合大多数任务

完整模式

  • 完整的浏览器模拟
  • 更好的平台兼容性
  • 推荐用于敏感操作

在请求中指定：

json
{
  "preferredEngine": "full"
}

你的第一个自动化 ​

让我们创建一个完整的自动化工作流：

示例：每日 Twitter 更新 ​

目标：每天在 Twitter 上发布更新

使用 API：

javascript
const response = await fetch('https://api.browserman.run/api/tasks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    platform: 'twitter',
    tool: 'createTweet',
    accountName: 'personal-twitter',
    parameters: {
      text: '每日更新：正在构建令人惊叹的东西！🚀'
    }
  })
});

const result = await response.json();
console.log('任务 ID:', result.taskId);

使用 Claude MCP：

只需告诉 Claude：

在我的 Twitter 账号上发布每日更新："每日更新：正在构建令人惊叹的东西！🚀"

示例：多平台发布 ​

目标：将相同消息发布到 Twitter 和雪球

使用 MCP：

将"今日市场趋势令人兴奋！"发布到我的 Twitter 和雪球账号

Claude 会自动：

  1. 找到你连接的账号
  2. 进行多次工具调用
  3. 报告结果

身份认证 ​

API 密钥 ​

要使用 REST API，你需要一个 API 密钥：

  1. 在控制台侧边栏点击 API 密钥
  2. 点击右上角的 + 新建密钥
  3. 给它起个名字（例如"生产 API"）
  4. 点击创建密钥
  5. 立即复制密钥（只显示一次）
  6. 安全存储

使用 API 密钥：

bash
# 在请求头中
Authorization: Bearer YOUR_API_KEY

# 示例
curl https://api.browserman.run/api/platforms \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxx"

MCP 身份认证 ​

对于 MCP，在 Claude 配置中配置 API 密钥：

json
{
  "mcpServers": {
    "browserman": {
      "url": "https://mcp.browserman.run",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

查看完整的 MCP 配置指南。

理解 API 端点 ​

基础 URL ​

https://api.browserman.run

关键端点 ​

平台

GET /api/platforms

列出所有支持的平台及其工具。

平台 Schema

GET /api/platforms/schema

获取所有平台的详细 schema。

账号

GET /api/accounts

列出你连接的账号。

任务

POST /api/tasks
GET /api/tasks/:taskId

创建和检查任务。

查看完整文档：API 参考

最佳实践 ​

1. 使用描述性账号名称 ​

好的：

personal-twitter
work-xueqiu
brand-official

不好的：

account1
test
a

2. 处理速率限制 ​

平台有速率限制。分散你的请求：

javascript
// 不好：太快
for (let i = 0; i < 100; i++) {
  await postTweet();
}

// 好的：添加延迟
for (let i = 0; i < 100; i++) {
  await postTweet();
  await sleep(60000); // 1 分钟延迟
}

3. 检查任务状态 ​

不要假设任务成功了。始终检查：

javascript
const task = await createTask();
const status = await checkTaskStatus(task.taskId);

if (status.state === 'completed') {
  console.log('成功！', status.result);
} else if (status.state === 'failed') {
  console.error('失败：', status.error);
}

4. 必要时使用完整模式 ​

对于重要操作或遇到检测问题时：

json
{
  "preferredEngine": "full"
}

5. 保护你的 API 密钥 ​

  • 永远不要将 API 密钥提交到版本控制
  • 使用环境变量
  • 定期轮换密钥
  • 为不同环境创建单独的密钥

常见工作流 ​

社交媒体管理 ​

javascript
// 早晨例程
await postTweet('早上好！☀️');
await postToXueqiu('今日市场分析...');

// 互动
await likeTweet(tweetUrl);
await retweet(tweetUrl);

// 晚间总结
await postTweet('每日总结：...');

内容分发 ​

javascript
// 发布到多个平台
const content = generateContent();

await Promise.all([
  postTweet(content.twitter),
  postToXueqiu(content.xueqiu),
  postToTonghuashun(content.tonghuashun)
]);

监控和告警 ​

javascript
// 检查重要更新
const mentions = await getMentions();

if (mentions.some(m => m.important)) {
  await postTweet('回复重要提及...');
}

故障排除 ​

问题："找不到账号" ​

解决方案：

  • 检查账号名称拼写
  • 使用 GET /api/accounts 列出可用账号
  • 确保账号已正确连接

问题："超过速率限制" ​

解决方案：

  • 在请求之间添加延迟
  • 检查特定平台的限制
  • 将请求分散到一段时间内

问题："身份验证失败" ​

解决方案：

  • 验证 API 密钥是否正确
  • 检查密钥是否过期
  • 确保包含"Bearer "前缀

查看 MCP 故障排除指南了解更多帮助。

下一步 ​

现在你理解了基础知识：

  1. 绑定更多账号 - 连接所有社交媒体
  2. 配置 MCP - 与 Claude 或 ChatGPT 配合使用
  3. 探索 API - 了解所有可用工具
  4. 查看示例 - 从实际用例中获得灵感

需要帮助？ ​

  • 文档 - 查看我们的全面指南
  • 控制台 - 访问 app.browserman.run
  • 支持 - 通过控制台联系我们

开始自动化吧！🚀

Copyright © 2025-present Browserman