Búsqueda web y scraping con MCP en agentes de OpenAI

​

Requisitos

• Una clave de API de OpenAI en OPENAI_API_KEY y el paquete de Python openai.
• Una clave de API de Firecrawl en FIRECRAWL_API_KEY.

​

Configuración rápida

import os
from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-6-astra",
    tools=[
        {
            "type": "mcp",
            "server_label": "firecrawl",
            "server_description": "Search the web and read pages as Markdown.",
            "server_url": "https://mcp.firecrawl.dev/v2/mcp",
            "authorization": os.environ["FIRECRAWL_API_KEY"],
            "allowed_tools": ["firecrawl_search", "firecrawl_scrape"],
            "require_approval": "never",
        }
    ],
    input="Search the web for the latest Next.js release notes and summarize the sources.",
)

print(response.output_text)

​

Pruébalo

Busca en la web las notas de la versión más recientes de TypeScript y resume las fuentes.

Haz scraping de https://firecrawl.dev y explica qué hace.

​

Qué puedes hacer

​

Solución de problemas

• La solicitud falla al listar las herramientas: comprueba que server_url sea exactamente https://mcp.firecrawl.dev/v2/mcp y que FIRECRAWL_API_KEY esté definida en el entorno donde se ejecuta el script.
• El servidor devuelve 401: reemplaza la clave y vuelve a enviar la solicitud, ya que OpenAI no conserva el valor de authorization entre solicitudes.
• Falta una herramienta: añade su nombre a allowed_tools o elimina allowed_tools para importar todas las herramientas que expone el servidor.
• El modelo responde sin utilizar Firecrawl: indica el nombre de la herramienta en tu prompt, por ejemplo: “Usa firecrawl_search para encontrar…”.