如何通过 MCP 将 OLX 连接到 Gemini

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

OLX + Gemini

在 Claude、ChatGPT 或 Copilot 中管理你的 OLX 分类信息账号（波兰、罗马尼亚、保加利亚、葡萄牙、乌克兰、哈萨克斯坦、乌兹别克斯坦）：带状态、统计数据和审核原因的广告，与买家的消息会话及回复，钱包余额、扣费记录和发票，以及类目、属性和地区。通过 OAuth 登录，每个国家安装一次。

前提条件

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

OLX_HOST, OLX_CLIENT_ID, OLX_CLIENT_SECRET

步骤 1 — 获取凭证

设置大约需要 10 分钟，另加 OLX 审核你的应用所需的时间。你需要一个在你销售所在国家的 OLX 站点上的账号，以及一个在该国 OLX 开发者门户上已获批准的应用。

1. 用你的 OLX 账号登录所在国家的开发者门户：developer.olx.pl（波兰）、developer.olx.ro（罗马尼亚）、developer.olx.bg（保加利亚）、developer.olx.pt（葡萄牙）、developer.olx.ua（乌克兰）、developer.olx.kz（哈萨克斯坦）或 developer.olx.uz（乌兹别克斯坦）。
2. 通过 Connect App 添加一个应用。在 redirect URI（波兰门户上叫 Adres powrotu）中，AnythingMCP Cloud 填写 https://cloud.anythingmcp.com/api/mcp-oauth/callback，自行托管 AnythingMCP 时填写 <your AnythingMCP URL>/api/mcp-oauth/callback。
3. 等待 OLX 批准应用。在此之前状态显示为 Waiting for acceptance；OLX 会发邮件通知你，批准后才会出现 Client ID 和 Client Secret。
4. 把它们分别粘贴到 OLX_CLIENT_ID 和 OLX_CLIENT_SECRET，并把 OLX_HOST 准确设为你所在国家的站点，例如 https://www.olx.pl、https://www.olx.ro 或 https://www.olx.ua，不要带路径或末尾斜杠。它必须是注册应用的那个国家。
5. 安装连接器，打开它并点击 Authorize with Provider。用你希望 AI 查看其广告的 OLX 账号登录并批准访问（连接器会申请 v2 read write 权限范围）。然后运行 olx_get_me：它会显示当前登录的用户，并确认 OLX_HOST 的国家是正确的。

每个国家安装一次：每个 OLX 国家都是独立的站点，账号、应用注册和类目各不相同。如果你同时在波兰和罗马尼亚销售，就安装两次连接器，并在名称中注明国家。OLX 巴西运行在另一个平台上，不在支持范围内。

用的是谁的账号：所有使用这个连接器的人读取的都是授权它的那个账号的广告和消息。请使用卖家账号，并在共享之前想好要给谁使用。

可读取的内容：你自己的广告，包括状态（active、limited、outdated、moderated 或 blocked）、标题、价格、类目、地区、联系方式、有效期和链接；广告的完整详情，包括描述、属性和图片；每条广告的统计（浏览量、电话号码显示次数、收藏数）；审核拒绝或封禁某条广告的原因；广告上当前生效的付费推广；与买家的消息会话及未读数、会话中的消息和对方的公开资料；你的商家资料；OLX 钱包余额和赠送额度、扣费记录以及预付和后付发票；还有发布广告需要的参考数据：带必填属性的类目、根据广告标题推荐的类目、地区、城市、城区，以及与一组坐标对应的城市。

只有你自己的广告：OLX 没有搜索他人广告的 API，因此 AI 无法浏览整个平台或查看竞争对手的广告。

安装时关闭：olx_send_message、olx_mark_thread_read、olx_deactivate_advert 和 olx_delete_advert。消息会立即发给真实的买家且无法撤回；下架会让广告从站点上消失（重新上架可能收费，所以这里不提供）；删除会把广告连同统计和消息永久删除。管理员只开启团队需要的那几个。

每次修改前都会询问：开启写入工具后，AI 会先展示会话和要发送的确切文字，或要处理的广告，等你同意后才发送或下架。

消息不可信：买家的消息里可能夹带针对 AI 的指令。AI 把消息文本当作要阅读的内容，而不是命令。

限制：OLX 每个 IP 地址每 5 分钟大约允许 4,500 次请求，超出后会把该地址封禁 30 分钟。因此 AI 会以平稳的节奏翻阅长列表，而不是快速循环请求。

常见错误：401 invalid_token 表示登录已过期或被撤销：请再次点击 Authorize with Provider。登录时出现 invalid_client 表示应用尚未获批，或者 Client ID 和 Secret 来自另一个国家的门户。404 表示当前登录的账号看不到该广告、会话或用户；对商家资料而言，表示该账号不是商家账号。

该连接器不会创建、编辑、上架或推广广告，不会购买付费推广或套餐，也不会动用 OLX 钱包里的钱：这些仍在 OLX 网站上完成。

步骤 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 现在可以调用 OLX 的工具。

可用工具

示例提示

• “我的哪些广告被审核拦下或封禁了？OLX 要求我修改什么？”
• “哪些买家会话里有未读消息？帮我概括每位买家在问什么。”
• “列出我在线广告的浏览量、电话显示次数和收藏数，并告诉我哪几条关注度最低。”
• “我的 OLX 钱包还剩多少钱？上个月都因为什么被扣费？”
• “我想在华沙卖一部二手 iPhone 13 128 GB：应该选哪个类目？那里有哪些必填属性？”

FAQ

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

下一步

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