Skip to main content

ApifyActorsTool

Integrate Apify Actors into your CrewAI workflows.

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

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

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

Expected output

Here is the output from running the code above:
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:
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

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