Amazon MCP Server

Extrai e pesquisa produtos na Amazon.

Documentação

Amazon MCP Server

Este é um servidor Model Context Protocol (MCP) para extrair dados de produtos da Amazon e pesquisar produtos na Amazon.

Configuração

  1. Clone o repositório:

    git clone https://github.com/r123singh/amazon-mcp-server.git
    
  2. Navegue até o diretório do projeto:

    cd amazon-mcp-server
    
  3. Crie um ambiente virtual:

    python -m venv venv
    
  4. Ative o ambiente virtual:

    • No Linux/macOS:
      source venv/bin/activate
      
    • No Windows:
      venv\Scripts\activate
      
  5. Instale as dependências:

    pip install -r requirements.txt
    
  6. Nenhuma chave de API ou token é necessária.

  7. Configure o JSON do MCP: Crie um arquivo mcp.json com:

    {
      "mcpServers": {
        "amazon": {
          "command": "{PATH_TO_DIRECTORY}\\amazon-mcp-server\\venv\\Scripts\\python.exe",
          "args": [
            "{PATH_TO_DIRECTORY}\\amazon-mcp-server\\server.py"
          ]
        }
      }
    }
    

    Substitua {PATH_TO_DIRECTORY} pelo caminho absoluto para este diretório (use pwd ou cd para obter o caminho).

Ferramentas Disponíveis

O servidor fornece as seguintes ferramentas para interagir com a Amazon:

  • Extrair dados de um produto:
    scrape_product(product_url)
    Extrai detalhes do produto (nome, preço, imagem, avaliação, comentários, disponibilidade, descrição) a partir de uma URL de produto da Amazon.

  • Pesquisar produtos:
    search_products(query, max_results)
    Pesquisa produtos na Amazon por palavra-chave e retorna uma lista de resultados.

Uso

Uma vez configurado, o servidor MCP pode ser iniciado usando a configuração padrão do cliente MCP. O servidor fornece uma interface em linguagem natural para interagir com a Amazon por meio das ferramentas disponíveis.

Exemplo de uso:

  • "Obtenha detalhes deste produto da Amazon: [URL do produto]"
  • "Pesquise na Amazon por 'fones de ouvido sem fio', mostre os 3 principais resultados"

Notas

  • Nenhuma chave de API ou autenticação é necessária.
  • O servidor extrai dados de páginas públicas de produtos e de pesquisa da Amazon.
  • Para melhores resultados, use URLs válidas de produtos da Amazon e consultas de pesquisa claras.

Contribuição

Contribuições são bem-vindas! Abra uma issue ou envie um pull request.

Licença

Este projeto está licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.