Amazon MCP Server

Extrae y busca productos en Amazon.

Documentación

Servidor MCP de Amazon

Este es un servidor de Protocolo de Contexto de Modelo (MCP) para extraer productos de Amazon y buscar productos en Amazon.

Configuración

  1. Clona el repositorio:

    git clone https://github.com/r123singh/amazon-mcp-server.git
    
  2. Navega al directorio del proyecto:

    cd amazon-mcp-server
    
  3. Crea un entorno virtual:

    python -m venv venv
    
  4. Activa el entorno virtual:

    • En Linux/macOS:
      source venv/bin/activate
      
    • En Windows:
      venv\Scripts\activate
      
  5. Instala las dependencias:

    pip install -r requirements.txt
    
  6. No se requieren claves API ni tokens.

  7. Configura el JSON de MCP: Crea un archivo mcp.json con:

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

    Reemplaza {PATH_TO_DIRECTORY} con la ruta absoluta a este directorio (usa pwd o cd para obtener la ruta).

Herramientas Disponibles

El servidor proporciona las siguientes herramientas para interactuar con Amazon:

  • Extraer un producto:
    scrape_product(product_url)
    Extrae los detalles del producto (nombre, precio, imagen, calificación, reseñas, disponibilidad, descripción) desde una URL de producto de Amazon.

  • Buscar productos:
    search_products(query, max_results)
    Busca productos en Amazon por palabra clave y devuelve una lista de resultados.

Uso

Una vez configurado, el servidor MCP se puede iniciar usando la configuración estándar del cliente MCP. El servidor proporciona una interfaz de lenguaje natural para interactuar con Amazon a través de las herramientas disponibles.

Ejemplo de uso:

  • "Obtén los detalles de este producto de Amazon: [URL del producto]"
  • "Busca en Amazon 'auriculares inalámbricos', muestra los 3 mejores resultados"

Notas

  • No se requiere clave API ni autenticación.
  • El servidor extrae páginas de productos y búsqueda de Amazon disponibles públicamente.
  • Para obtener mejores resultados, usa URLs de productos de Amazon válidas y consultas de búsqueda claras.

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, abre un issue o envía una solicitud de extracción (pull request).

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.