Oxylabs

What is the Oxylabs tool?

The Oxylabs tool is a built-in capability in the Agno framework that allows AI agents to web scraping via oxylabs proxy network. When added to an agent in Agno Builder, the agent can autonomously decide when to invoke this tool based on the user's request.

This tool requires a OXYLABS_USERNAME environment variable. Get your API key at oxylabs.io.

How to use Oxylabs in Agno Builder

1. 1

   Create an agent

   Drag an Agent node onto the canvas in Agno Builder, or use one of the built-in templates.

2. 2

   Enable Oxylabs

   Click the agent, go to the Tools tab, and toggle on "Oxylabs" from the scraping category.

3. 3

   Add your API key

   Enter your OXYLABS_USERNAME in the tool configuration. Your key stays in your browser and is never stored on our servers.

4. 4

   Test in chat

   Open the chat panel and send a message. The agent will automatically use Oxylabs when relevant.

5. 5

   Export Python code

   Click File > Export Python to get clean, runnable code with the correct imports for Oxylabs.

Python code example

This is the code Agno Builder exports when you use Oxylabs:

from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.oxylabs import OxylabsTools

agent = Agent(
    name="Oxylabs Agent",
    model=OpenAIChat(id="gpt-4o"),
    tools=[OxylabsTools()],
    instructions=["Use the oxylabs tool to help the user."],
    markdown=True,
)

agent.print_response("Help me with a oxylabs task")

Install with: pip install agno # + set OXYLABS_USERNAME