Skip to content
CrewAI Documentation

Apify Actors

ApifyActorsTool

Section titled “ApifyActorsTool”

Integrate Apify Actors into your CrewAI workflows.

Description

Section titled “Description”

The ApifyActorsTool connects Apify Actors, cloud-based programs for web scraping and automation, to your CrewAI workflows. Use any of the 4,000+ Actors on Apify Store for use cases such as extracting data from social media, search engines, online maps, e-commerce sites, travel portals, or general websites.

For details, see the Apify CrewAI integration in Apify documentation.

Steps to get started

Section titled “Steps to get started”
  1. Install dependencies

    Install crewai[tools] and langchain-apify using pip: pip install 'crewai[tools]' langchain-apify.

  2. Obtain an Apify API token

    Sign up to Apify Console and get your Apify API token..

  3. Configure environment

    Set your Apify API token as the APIFY_API_TOKEN environment variable to enable the tool’s functionality.

Usage example

Section titled “Usage example”

Use the ApifyActorsTool manually to run the RAG Web Browser Actor to perform a web search:

from crewai_tools import ApifyActorsTool


# Initialize the tool with an Apify Actor
tool = ApifyActorsTool(actor_name="apify/rag-web-browser")


# Run the tool with input parameters
results = tool.run(run_input={"query": "What is CrewAI?", "maxResults": 5})


# Process the results
for result in results:
    print(f"URL: {result['metadata']['url']}")
    print(f"Content: {result.get('markdown', 'N/A')[:100]}...")

Expected output

Section titled “Expected output”

Here is the output from running the code above:

URL: https://www.example.com/crewai-intro
Content: CrewAI is a framework for building AI-powered workflows...
URL: https://docs.crewai.com/
Content: Official documentation for CrewAI...

The ApifyActorsTool automatically fetches the Actor definition and input schema from Apify using the provided actor_name and then constructs the tool description and argument schema. This means you need to specify only a valid actor_name, and the tool handles the rest when used with agents—no need to specify the run_input. Here’s how it works:

from crewai import Agent
from crewai_tools import ApifyActorsTool


rag_browser = ApifyActorsTool(actor_name="apify/rag-web-browser")


agent = Agent(
    role="Research Analyst",
    goal="Find and summarize information about specific topics",
    backstory="You are an experienced researcher with attention to detail",
    tools=[rag_browser],
)

You can run other Actors from Apify Store simply by changing the actor_name and, when using it manually, adjusting the run_input based on the Actor input schema.

For an example of usage with agents, see the CrewAI Actor template.

Configuration

Section titled “Configuration”

The ApifyActorsTool requires these inputs to work:

  • actor_name The ID of the Apify Actor to run, e.g., "apify/rag-web-browser". Browse all Actors on Apify Store.
  • run_input A dictionary of input parameters for the Actor when running the tool manually.
    • For example, for the apify/rag-web-browser Actor: {"query": "search term", "maxResults": 5}
    • See the Actor’s input schema for the list of input parameters.

Resources

Section titled “Resources”