# Mercado Libre Scraper Mexico (ISP Proxies) (`cap-capibara/neuroprox-mercadolibre-scraper`) Actor

Scrape Mercado Libre listings and item details from Mexico first (mercadolibre.com.mx), with other LATAM sites available. Runs on Mexican residential ISP infrastructure, MCP ready for your AI Agent.

- **URL**: https://apify.com/cap-capibara/neuroprox-mercadolibre-scraper.md
- **Developed by:** [Captain Capibara](https://apify.com/cap-capibara) (community)
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Mercado Libre Scraper do?

**Mercado Libre Scraper** extracts public product listings, prices, and product details from **Mercado Libre Mexico** ([mercadolibre.com.mx](https://www.mercadolibre.com.mx)) and 17 other Latin American countries. Search by keyword, paste category or product URLs, and get a clean dataset with title, price, discount, seller, reviews, units sold, shipping, condition, location, and images. Turn on detail mode to also get the full specifications table and description.

It works as an easy **Mercado Libre API alternative**: no Mercado Libre account, API key, or proxies needed. Enter what you want, click **Start**, and download your data as JSON, CSV, or Excel. You can also run it from an **AI agent** through MCP.

### Why use this Mercado Libre scraper?

- 💰 **Low price, no start fee.** $0.80 per 1,000 listings. You only pay for results you get.
- ⚡ **Fast.** A typical search returns 20 results in about 10 seconds.
- 🇲🇽 **Built for Mexico.** Runs from local Mexican IPs, so you see the same prices, stock, and shipping that Mexican shoppers see.
- 🌎 **18 countries.** Mexico, Argentina, Brazil, Colombia, Chile, Peru, and more.
- 🤖 **Ready for AI agents.** Use it from Claude, Cursor, or any MCP client.
- 🔌 **Works with your tools.** Schedule runs, call it from the API, or connect it to Make, n8n, Zapier, or Google Sheets.

### Use cases

- **Mercado Libre price monitoring.** Track competitors' prices and discounts every day with a scheduled run.
- **Market research.** See who sells what, at what price, and how many units they've sold.
- **Product catalogs.** Pull full specifications, descriptions, and photo galleries.
- **Seller analysis.** Compare reputation, ratings, and official stores.
- **E-commerce and dropshipping.** Find best-selling products and price gaps across Latin America.

### What data can it extract from Mercado Libre?

| Field | Description |
| --- | --- |
| `title` | Listing title |
| `price` / `currency` | Current price and currency (MXN in Mexico) |
| `original_price` / `discount_percent` | Price before discount, when shown |
| `condition` | New or used |
| `seller_nickname`, `seller_reputation_level` | Seller and reputation |
| `rating_average`, `reviews_count` | Product reviews |
| `sold_quantity` | Units sold, when Mercado Libre shows it |
| `free_shipping`, `shipping_logistic_type` | Free shipping and Mercado Libre Full |
| `location_state`, `location_city` | Seller location |
| `item_id`, `permalink` | Product ID and link |
| `images` | Thumbnail, plus the full gallery in detail mode |
| `attributes`, `description` | Specifications table and description (detail mode) |

### How to scrape Mercado Libre prices

1. Click **Try for free**.
2. Choose a country (Mexico is the default).
3. Enter keywords such as `iphone 15`, or paste Mercado Libre search, category, or product links.
4. Set **Max items**, and add filters if you want: price range, new or used, free shipping, official stores, sort order.
5. Turn on **Fetch item detail pages** only if you need specifications and descriptions.
6. Click **Start**, then download your data.

### How much does it cost to scrape Mercado Libre?

You pay only for results that are saved. No start fee.

| Result | Price | Per 1,000 |
| --- | --- | --- |
| Listing (search result) | $0.0008 | $0.80 |
| Listing with full details | $0.003 | $3.00 |

Sponsored listings you skip with **Exclude sponsored listings** are not charged. To cap your spend, set a maximum cost per run in the run options.

### Use with AI agents (MCP)

Give an AI agent live access to Mercado Libre through the [Model Context Protocol](https://docs.apify.com/platform/integrations/mcp). Add this Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=cap-capibara/neuroprox-mercadolibre-scraper"
```

For Cursor or other MCP clients, add this server URL:

```
https://mcp.apify.com?tools=cap-capibara/neuroprox-mercadolibre-scraper
```

Then ask in plain language, for example:

- "Find the 20 cheapest new iPhone 15 listings on Mercado Libre Mexico."
- "Compare prices for Nike running shoes on Mercado Libre Mexico and Argentina."
- "Get the specs and seller rating for this Mercado Libre product: \[link]."

The agent runs the scraper and reads back the results. You need an Apify account.

### Example input

```json
{
  "siteId": "MLM",
  "searchQueries": ["iphone 15"],
  "maxItems": 50,
  "condition": "new",
  "sort": "price_asc"
}
```

### Example output

```json
{
  "item_id": "MLM1234567890",
  "title": "iPhone 15 128 GB",
  "price": 15999,
  "currency": "MXN",
  "original_price": 18999,
  "discount_percent": 15.79,
  "condition": "new",
  "free_shipping": true,
  "seller_nickname": "TIENDAOFICIAL",
  "location_state": "Ciudad De México",
  "permalink": "https://articulo.mercadolibre.com.mx/MLM-1234567890-...",
  "kind": "listing"
}
```

### FAQ

**Which Mercado Libre countries are supported?**
Mexico, Argentina, Brazil (Mercado Livre), Colombia, Chile, Peru, Uruguay, Venezuela, Ecuador, Bolivia, Panama, Paraguay, Dominican Republic, Costa Rica, Nicaragua, Guatemala, Honduras, and El Salvador.

**Do I need the Mercado Libre API, proxies, or an account?**
No. Everything is included in the price.

**Can I monitor Mercado Libre prices automatically?**
Yes. Create a schedule in Apify (daily or hourly) and send results to Google Sheets, a webhook, Make, n8n, or Zapier.

**How many results can I get per run?**
Up to 10,000.

**Can I scrape a single Mercado Libre product?**
Yes. Paste the product link in **Start URLs** and you get its full details.

**Is scraping Mercado Libre legal?**
This Actor collects only public data that Mercado Libre shows to every shopper. Don't collect personal data without a legitimate reason, and check with a lawyer if you're unsure.

**Something isn't working or I need a custom field?**
Open an issue in the **Issues** tab and we'll get back to you.

# Actor input Schema

## `siteId` (type: `string`):

Mercado Libre marketplace. Mexico is first-class; other LATAM sites share the same search/item page layout.

## `searchQueries` (type: `array`):

Free-text queries, one per line. Run against the selected country site.

## `categoryUrls` (type: `array`):

Mercado Libre category or search listing URLs (e.g. https://listado.mercadolibre.com.mx/celulares).

## `startUrls` (type: `array`):

Mix of search, category, or item (articulo) URLs. Item URLs are fetched as details automatically.

## `maxItems` (type: `integer`):

Stop after this many successful dataset rows. 0 means the backend cap (10,000).

## `includeDetails` (type: `boolean`):

Enrich each listing with description, gallery, attributes, sold quantity, and reviews. Charged as a detail event instead of a listing.

## `priceMin` (type: `integer`):

Lower bound in the site currency (MXN for Mexico).

## `priceMax` (type: `integer`):

Upper bound in the site currency.

## `condition` (type: `string`):

Filter new or used listings.

## `sort` (type: `string`):

Listing sort order.

## `freeShippingOnly` (type: `boolean`):

Free shipping only

## `officialStoresOnly` (type: `boolean`):

Official stores only

## `excludeSponsored` (type: `boolean`):

Skip promoted cards. They are not charged.

## Actor input object example

```json
{
  "siteId": "MLM",
  "searchQueries": [
    "iphone 15"
  ],
  "maxItems": 50,
  "includeDetails": false,
  "condition": "any",
  "sort": "relevance",
  "freeShippingOnly": false,
  "officialStoresOnly": false,
  "excludeSponsored": false
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "iphone 15"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("cap-capibara/neuroprox-mercadolibre-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchQueries": ["iphone 15"] }

# Run the Actor and wait for it to finish
run = client.actor("cap-capibara/neuroprox-mercadolibre-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "iphone 15"
  ]
}' |
apify call cap-capibara/neuroprox-mercadolibre-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,cap-capibara/neuroprox-mercadolibre-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/RpsThFkXhOUKiPDDc/builds/IEaKRDlMlASqmDNNg/openapi.json