Firecrawl + OpenAI

pip install -U openai firecrawl-py
export FIRECRAWL_API_KEY="fc-YOUR-API-KEY"
export OPENAI_API_KEY="sk-YOUR-API-KEY"

import json

from firecrawl import Firecrawl
from openai import OpenAI

client = OpenAI()
firecrawl = Firecrawl()

tools = [
    {
        "type": "function",
        "name": "web_search",
        "description": "Search the web with Firecrawl. Returns titles, URLs and descriptions.",
        "parameters": {
            "type": "object",
            "properties": {"query": {"type": "string", "description": "The search query"}},
            "required": ["query"],
            "additionalProperties": False,
        },
        "strict": True,
    }
]

def web_search(query: str) -> str:
    results = firecrawl.search(query, limit=5)
    return json.dumps(
        [{"title": r.title, "url": r.url, "description": r.description} for r in (results.web or [])]
    )

input_list = [{"role": "user", "content": "What did OpenAI ship this week? Cite sources."}]

while True:
    response = client.responses.create(model="gpt-6-luna", tools=tools, input=input_list)
    calls = [item for item in response.output if item.type == "function_call"]
    if not calls:
        break
    input_list += response.output
    for call in calls:
        query = json.loads(call.arguments)["query"]
        input_list.append(
            {"type": "function_call_output", "call_id": call.call_id, "output": web_search(query)}
        )

print(response.output_text)

pip install -U openai-agents firecrawl-py

from agents import Agent, Runner, function_tool
from firecrawl import Firecrawl

firecrawl = Firecrawl()

@function_tool
def firecrawl_search(query: str, limit: int = 5) -> str:
    """Search the web with Firecrawl and return titles, URLs and descriptions.

    Args:
        query: The search query.
        limit: Maximum number of results.
    """
    results = firecrawl.search(query, limit=limit)
    return "\n\n".join(f"{r.title}\n{r.url}\n{r.description}" for r in (results.web or []))

agent = Agent(
    name="Research assistant",
    instructions="Use firecrawl_search for anything current and cite the URLs you used.",
    model="gpt-6-luna",
    tools=[firecrawl_search],
)

result = Runner.run_sync(agent, "What changed in the latest OpenAI Agents SDK release?")
print(result.final_output)