MCP 服务器

Rally MCP Server

An MCP server that provides AI assistants with tools for Mercado Libre and Shopee affiliate marketing, including product search, affiliate link generation, product analysis, copy generation, and trending product discovery.

README

Rally MCP Server — Marketplace Affiliate Tools

The first Model Context Protocol (MCP) server for Mercado Libre & Shopee affiliates.

Built by André Hocsis — Creator of Rally de Vendas, the leading AI-powered platform for Brazilian e-commerce sellers and affiliates.

What is this?

An MCP server that gives AI assistants (Claude, ChatGPT, Cursor, etc.) direct access to marketplace affiliate tools:

Search products on Mercado Libre and Shopee with commission estimates
Generate affiliate links with tracking
Analyze products (quality score 0-100, photos, title, price competitiveness)
Generate marketing copy for TikTok, Reels, WhatsApp, Telegram, Blog
Check trending products by category and season

Why?

Mercado Libre has no affiliate API. Shopee's API is complex. This MCP server abstracts both into a simple, unified interface that any AI agent can use.

Quick Start

# Install
npm install @rally-vendas/mcp-server

# Or run directly
npx @rally-vendas/mcp-server

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "rally-affiliates": {
      "command": "npx",
      "args": ["@rally-vendas/mcp-server"],
      "env": {
        "ML_AFFILIATE_ID": "your_matt_tool_id",
        "SHOPEE_APP_ID": "your_app_id",
        "SHOPEE_SECRET": "your_secret"
      }
    }
  }
}

Available Tools

`search_products`

Search products across marketplaces with affiliate commission estimates.

{
  "marketplace": "mercadolibre",
  "query": "fone bluetooth",
  "category": "MLB1051",
  "sort": "relevance",
  "limit": 20
}

Returns: Product list with title, price, image, commission rate, estimated earnings, affiliate link.

`generate_affiliate_link`

Generate a tracked affiliate link for any product.

{
  "marketplace": "mercadolibre",
  "product_url": "https://www.mercadolivre.com.br/produto-xyz/p/MLB12345",
  "campaign": "tiktok_maio"
}

Returns: Affiliate URL with tracking parameters.

`analyze_product`

Get a quality score (0-100) for any marketplace product.

{
  "marketplace": "mercadolibre",
  "product_id": "MLB12345"
}

Returns: Score breakdown (title, photos, description, attributes, price), problems found, improvement suggestions.

`generate_copy`

AI-powered marketing copy for any channel.

{
  "product_id": "MLB12345",
  "channel": "tiktok",
  "tone": "casual",
  "language": "pt-BR"
}

Returns: Ready-to-post copy with hashtags, emojis, and CTA.

`trending_products`

Get trending products by category with commission data.

{
  "marketplace": "mercadolibre",
  "category": "MLB1051",
  "period": "7d"
}

Returns: Top products by sales velocity, with commission estimates.

`commission_calculator`

Calculate expected earnings for a product.

{
  "marketplace": "mercadolibre",
  "product_id": "MLB12345",
  "estimated_daily_clicks": 50,
  "conversion_rate": 0.02
}

Returns: Daily/monthly/yearly estimated commission in BRL.

Supported Marketplaces

Marketplace	Search	Links	Analytics	Reports
Mercado Libre (Brazil)	✅	✅ (matt_tool)	✅ (Raio-X)	Estimated
Shopee (Brazil)	✅	✅ (API)	✅	✅ Real-time
Amazon (coming soon)	⏳	⏳	⏳	⏳

Architecture

rally-mcp-server/
├── src/
│   ├── index.ts              — MCP server entry point
│   ├── tools/
│   │   ├── search.ts         — Product search (ML + Shopee)
│   │   ├── links.ts          — Affiliate link generation
│   │   ├── analyze.ts        — Product analysis (Raio-X)
│   │   ├── copy.ts           — AI copy generation
│   │   └── trending.ts       — Trending products
│   ├── adapters/
│   │   ├── mercadolibre.ts   — ML API adapter
│   │   └── shopee.ts         — Shopee API adapter
│   └── utils/
│       ├── commission.ts     — Commission calculator
│       └── cache.ts          — Request caching
├── package.json
├── tsconfig.json
└── README.md

Built With

Model Context Protocol SDK — Anthropic's MCP
Mercado Libre API — Product data
Shopee Affiliate API — Affiliate operations

About Rally de Vendas

Rally de Vendas is a Brazilian AI-powered e-commerce platform that helps:

Sellers: Manage Mercado Libre listings with AI optimization, Raio-X diagnostics, bulk management
Affiliates: Discover products, generate tracked links, create content with AI, automate WhatsApp/Telegram
Agencies: Multi-account management, centralized inbox, dynamic pricing

500+ routes · 90+ controllers · AI-powered (Claude + Gemini) · ISO 9001 + 27001 compliant