如何通过 MCP 将 Avito 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Avito、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Avito + Gemini

让你的 AI 使用你的 Avito 企业账户：列出广告并修改价格，读取浏览、联系和来电统计，检查自动上传 (autoload) 的上传记录及其错误、Feed 格式和钱包，并读取 Avito Messenger 聊天。发送消息和修改自动上传设置为可选功能，默认关闭。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

AVITO_CLIENT_ID, AVITO_CLIENT_SECRET

步骤 1 — 获取凭证

设置大约需要 5 分钟，需要一个 Avito 企业账户及其 API 凭证。无需在浏览器中登录授权。

1. 用 AI 要使用的企业账户登录 Avito：应是公司的主账户，而不是员工账户。
2. 打开 Для профессионалов，再进入 API интеграции（avito.ru/professionals/api），复制 Client ID 和 Client secret。Avito 每个账户只发放一对凭证，生成新的 secret 后旧的会立即失效。
3. 把它们分别粘贴到 AVITO_CLIENT_ID 和 AVITO_CLIENT_SECRET 并安装。AnythingMCP 会自行向 Avito 获取访问令牌，并每 24 小时续期一次。
4. 运行 avito_get_self：它会显示账户的名称、邮箱和用户 ID。这个 ID 就是其他工具需要的 user_id，AI 会在整个对话中重复使用。

能用哪些功能取决于你的 Avito 套餐：API 能做的就是该账户本身被允许做的事。Messenger API 仅在商品和招聘类目的 Максимальный（最高级）套餐，以及服务类目的 Расширенный（扩展）或 Максимальный 套餐中提供；没有它，聊天类工具会返回 403。自动上传类工具要求账户中已设置自动上传。

可读取的内容：账户和钱包（卢布实际余额和奖励金）以及发布和推广的扣费记录；你的广告，包括标题、价格、状态、类目、地址，以及已使用的付费服务（vip、highlight、pushup、premium、xl）和到期日；一次最多 200 条广告、最长回溯 270 天的独立浏览、联系和收藏数据；按广告和按天统计的来电；自动上传设置、每次上传及其中每条广告的错误和警告；每个类目的 Feed 字段；以及 Avito Messenger 中的聊天和消息。员工子账户的广告不会列出，读取聊天也不会将其标为已读。

每条广告有两个 ID：Avito ID 是广告链接中的数字；来自自动上传 Feed 的广告还有 Feed 自己的 Id。AI 会在两者之间转换，所以你用哪个 ID 提问都可以。

每次修改前都会询问：avito_update_item_price 以整数卢布修改一条广告的价格（适用于商品、配件、汽车和房产，不含短租）。新价格会立即公开，因此 AI 会先告诉你是哪条广告、原价和新价，等你同意后再执行。如果广告来自自动上传 Feed，下一次上传可能会恢复 Feed 中的价格：请同时修改 Feed。

安装时关闭：avito_send_message（以账户名义给买家发消息，最多 1,000 个字符，在这里无法撤回），avito_mark_chat_read（未读标记会消失，同事可能错过这条消息），avito_update_autoload_profile（会替换整个自动上传配置）和 avito_start_autoload_upload（无视排期限制，一次性发布 Feed 中所有广告，可能产生发布费用，且每小时最多一次）。管理员可以有意识地开启它们，即便如此，AI 也会先展示确切的消息内容或设置变更，等你确认。

买家数据：聊天中包含买家的姓名和消息。AI 只用它们来回复这些买家，绝不会主动联系没有先发消息的人。

时间和语言：Avito 使用莫斯科时间（UTC+3），AI 会先换算再告诉你。Avito 返回的提示是俄语，AI 会为你翻译。

限制：列出广告每分钟最多 25 次请求，修改价格每分钟 150 次，读取单条广告每分钟 500 次。钱包记录每次最多查询一周，最远回溯一年。遇到 429 时，AI 会等一分钟再重试。

常见错误：401 Bad bearer token 或 403 invalid access token 表示 Client ID 或 secret 错误，或已被新生成的 secret 替换。其他 403 表示套餐不包含该 API（主要是 Messenger）。404 表示广告、聊天或上传记录不存在或属于其他账户；在还没有任何上传时，自动上传报告也会返回 404。400 表示参数有误，例如在此处不允许改价的类目中改价，或钱包查询区间超过一周。

该连接器不涉及推广服务及其价格、广告活动、CPA 和来电追踪、配送和订单、评分和评价、Avito Jobs、短租、员工账户、Webhook，也不发送图片或语音消息；它不会创建或编辑广告内容，这些通过你的自动上传 Feed 完成。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Avito 的工具。

可用工具

示例提示

• “过去 30 天里，我的哪些在线广告浏览和联系最多？哪些完全没人问？”
• “把我的‘iPhone 13 128 GB’广告降价到 42,000 卢布。先给我看原价和新价。”
• “上一次自动上传有没有错误？列出有错误的广告，并告诉我 Feed 里要改什么。”
• “Avito Messenger 里哪些聊天还没读？买家都在问什么？”
• “上周我的 Avito 钱包扣了多少钱、都花在哪里？现在余额是多少？”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT