olx-mcp
MCP server para buscar anúncios públicos da OLX Brasil via scraping do __NEXT_DATA__.
Instalação
pip install olx-mcp
Configuração no Claude Desktop
Edite ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"olx-mcp": {
"command": "olx-mcp"
}
}
}
Configuração no Claude Code
claude mcp add olx-mcp olx-mcp
Ferramentas
olx_buscar_anuncios
Busca anúncios com filtros.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query |
string | Sim | Termo de busca |
estado |
string | Não | Sigla do estado (sp, rj, go…) |
categoria |
string | Não | Slug de categoria (celulares, imoveis…) |
preco_min |
int | Não | Preço mínimo em reais |
preco_max |
int | Não | Preço máximo em reais |
ordenar |
string | Não | relevance | price | date |
pagina |
int | Não | Página (1–50) |
olx_detalhe_anuncio
Retorna detalhes completos de um anúncio pela URL.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
url |
string | Sim | URL completa do anúncio na OLX |
Exemplos de uso
Busque notebooks usados em São Paulo por até R$ 2000, ordenados por menor preço.
Me dê os detalhes do anúncio: https://sp.olx.com.br/...
Desenvolvimento
git clone https://github.com/rodrigopg/olx-mcp
cd olx-mcp
python -m venv .venv
.venv/bin/pip install -e ".[dev]"
Aviso
Este servidor faz scraping de dados públicos da OLX Brasil. Use com responsabilidade e respeite os termos de uso do site.
Licença
MIT
1 maintainer
Metadata
1 maintainer
Release files for olx-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| olx_mcp-0.1.0.tar.gz | 11.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| olx_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 19.3 kB
Release files / olx_mcp-0.1.0.tar.gz
| Download URL | olx_mcp-0.1.0.tar.gz |
|---|---|
| Size | 11.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c43affd1e9fd32aedf059aa5bd22328dde59d1bec1319c0aa6a60e2a1e483d5f
|
|
BLAKE2b-256 checksum How to use checksums |
74d8bbfcd94a8b32091bffff24949fb1b2a5532c35cdeadc23c024fb2282367c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / olx_mcp-0.1.0-py3-none-any.whl
| Download URL | olx_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 7.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
14431bde2cf308a89ca8e9de4f0366e2d5c28eb8b67de3a67414cea770f9a507
|
|
BLAKE2b-256 checksum How to use checksums |
221c12cd7436bc2222321e38c337e89e05d09c6d39790fc762b8fd14341c468c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Security for olx-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
