From 40bc8f2204a5a7deffc29358bb92359b0e2ecb99 Mon Sep 17 00:00:00 2001 From: MQ37 Date: Fri, 5 Dec 2025 12:07:41 +0100 Subject: [PATCH 01/11] docs: add google adk integration --- .../platform/integrations/ai/google-adk.md | 102 ++++++++++++++++++ 1 file changed, 102 insertions(+) create mode 100644 sources/platform/integrations/ai/google-adk.md diff --git a/sources/platform/integrations/ai/google-adk.md b/sources/platform/integrations/ai/google-adk.md new file mode 100644 index 000000000..a4f144c25 --- /dev/null +++ b/sources/platform/integrations/ai/google-adk.md @@ -0,0 +1,102 @@ +--- +title: 🇬 Google ADK integration +sidebar_label: Google ADK +description: Learn how to integrate Apify Actors as tools for AI with 🇬 Google ADK. +sidebar_position: 2 +slug: /integrations/google-adk +--- + +**Learn how to integrate Apify Actors as tools for AI with Google ADK.** + +--- + +## What is Google ADK + +[Google Agent Development Kit (ADK)](https://github.com/google/adk-python) is a flexible and modular framework for developing and deploying AI agents. + +:::note Explore Google ADK + +For more in-depth details, check out [Google ADK documentation](https://google.github.io/adk-docs/). + +::: + +## How to use Apify with Google ADK + +Apify is a marketplace of ready-to-use web scraping and automation tools, AI agents, and MCP servers that you can equip your own AI with. This guide demonstrates how to use Apify tools with a simple AI agent built with Google ADK. + + +### Prerequisites + +- _Apify API token_: To use Apify Actors in Google ADK, you need an Apify API token. To obtain your token check [Apify documentation](https://docs.apify.com/platform/integrations/api). +- _Python packages_: Install the following Python packages: + + ```bash + pip install google-adk + ``` + +### Building a simple pub search AI agent using Apify Google Maps scraper + +First, create an agent project: + +```bash +adk create pub_search_agent +``` + +Create and configure the agent to use the Apify MCP server tools: + +:::warning Required setup + +Make sure to set the `APIFY_TOKEN` environment variable in the `.env` file with your Apify API token before running the code. + +::: + +```python +from google.adk.agents import Agent +from google.adk.tools.mcp_tool import McpToolset +from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams +import os + +root_agent = Agent( + model="gemini-2.5-flash", + name="pub_search_agent", + instruction="You are a pub search agent that helps users find a great pub to visit based on their preferences. Use Apify tools to accomplish this.", + tools=[ + McpToolset( + connection_params=StreamableHTTPServerParams( + # Configure Apify MCP Server URL with desired tools + url="https://mcp.apify.com?tools=compass/crawler-google-places", + headers={ + "Authorization": f"Bearer {os.getenv('APIFY_TOKEN')}", + }, + ), + ) + ], +) +``` + +Run the agent via the web interface: + +```bash +adk web +``` + +Or run the agent via command-line interface: + +```bash +adk run pub_search_agent +``` + +Prompt the agent to find a pub in San Francisco: + +```text +Find a pub near the Ferry Building in San Francisco. +``` + +## Resources + +- [Apify Actors](https://docs.apify.com/platform/actors) +- [Google ADK documentation](https://google.github.io/adk-docs/get-started/) +- [What are AI agents?](https://blog.apify.com/what-are-ai-agents/) +- [Apify MCP Server](https://mcp.apify.com) +- [Apify MCP Server documentation](https://docs.apify.com/platform/integrations/mcp) +- [Apify OpenRouter proxy](https://apify.com/apify/openrouter) From 58ed0c3a68baa72e7a08ccad1f5daf45b585c5f0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Kopeck=C3=BD?= Date: Tue, 9 Dec 2025 09:58:54 +0100 Subject: [PATCH 02/11] Update sources/platform/integrations/ai/google-adk.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/google-adk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/google-adk.md b/sources/platform/integrations/ai/google-adk.md index a4f144c25..adca69d58 100644 --- a/sources/platform/integrations/ai/google-adk.md +++ b/sources/platform/integrations/ai/google-adk.md @@ -1,7 +1,7 @@ --- title: 🇬 Google ADK integration sidebar_label: Google ADK -description: Learn how to integrate Apify Actors as tools for AI with 🇬 Google ADK. +description: Learn how to integrate Apify Actors as tools for AI with Google Agent Development Kit (ADK). sidebar_position: 2 slug: /integrations/google-adk --- From 314d83be2002707d613fcc8a5a730a53b7b33b3b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Kopeck=C3=BD?= Date: Tue, 9 Dec 2025 09:59:03 +0100 Subject: [PATCH 03/11] Update sources/platform/integrations/ai/google-adk.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/google-adk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/google-adk.md b/sources/platform/integrations/ai/google-adk.md index adca69d58..bc639f87d 100644 --- a/sources/platform/integrations/ai/google-adk.md +++ b/sources/platform/integrations/ai/google-adk.md @@ -6,7 +6,7 @@ sidebar_position: 2 slug: /integrations/google-adk --- -**Learn how to integrate Apify Actors as tools for AI with Google ADK.** +**Learn how to integrate Apify Actors as tools for AI with Agent Development Kit (ADK).** --- From dff79c18517b6bf9e4e4b9209bf9b969fc54323d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Kopeck=C3=BD?= Date: Tue, 9 Dec 2025 09:59:09 +0100 Subject: [PATCH 04/11] Update sources/platform/integrations/ai/google-adk.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/google-adk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/google-adk.md b/sources/platform/integrations/ai/google-adk.md index bc639f87d..8f0df4bf6 100644 --- a/sources/platform/integrations/ai/google-adk.md +++ b/sources/platform/integrations/ai/google-adk.md @@ -10,7 +10,7 @@ slug: /integrations/google-adk --- -## What is Google ADK +## What is the Google ADK [Google Agent Development Kit (ADK)](https://github.com/google/adk-python) is a flexible and modular framework for developing and deploying AI agents. From 43f58ad569cc43acb3adaf909c5d2d537ad03e0a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Kopeck=C3=BD?= Date: Tue, 9 Dec 2025 09:59:16 +0100 Subject: [PATCH 05/11] Update sources/platform/integrations/ai/google-adk.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/google-adk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/google-adk.md b/sources/platform/integrations/ai/google-adk.md index 8f0df4bf6..62c40ee86 100644 --- a/sources/platform/integrations/ai/google-adk.md +++ b/sources/platform/integrations/ai/google-adk.md @@ -12,7 +12,7 @@ slug: /integrations/google-adk ## What is the Google ADK -[Google Agent Development Kit (ADK)](https://github.com/google/adk-python) is a flexible and modular framework for developing and deploying AI agents. +[Google Agent Development Kit](https://github.com/google/adk-python) is a framework for developing and deploying AI agents. :::note Explore Google ADK From 03a0c73fdf9a08e309a8d2b311dbe2d4ef085538 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Kopeck=C3=BD?= Date: Tue, 9 Dec 2025 09:59:23 +0100 Subject: [PATCH 06/11] Update sources/platform/integrations/ai/google-adk.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/google-adk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/google-adk.md b/sources/platform/integrations/ai/google-adk.md index 62c40ee86..ad18b7b96 100644 --- a/sources/platform/integrations/ai/google-adk.md +++ b/sources/platform/integrations/ai/google-adk.md @@ -27,7 +27,7 @@ Apify is a marketplace of ready-to-use web scraping and automation tools, AI age ### Prerequisites -- _Apify API token_: To use Apify Actors in Google ADK, you need an Apify API token. To obtain your token check [Apify documentation](https://docs.apify.com/platform/integrations/api). +- _Apify API token_: To use Apify Actors in Google ADK, you need an Apify API token. To obtain your token, check [Apify documentation](/platform/integrations/api#api-token). - _Python packages_: Install the following Python packages: ```bash From 415804cd8dfa27af036d75fd807758b4b6aefc5b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Kopeck=C3=BD?= Date: Tue, 9 Dec 2025 09:59:30 +0100 Subject: [PATCH 07/11] Update sources/platform/integrations/ai/google-adk.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/google-adk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/google-adk.md b/sources/platform/integrations/ai/google-adk.md index ad18b7b96..9d38c2f0e 100644 --- a/sources/platform/integrations/ai/google-adk.md +++ b/sources/platform/integrations/ai/google-adk.md @@ -34,7 +34,7 @@ Apify is a marketplace of ready-to-use web scraping and automation tools, AI age pip install google-adk ``` -### Building a simple pub search AI agent using Apify Google Maps scraper +### Build a pub search AI agent First, create an agent project: From 6fa246440ffa24292c4dc8d4910d11a5537c834c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Kopeck=C3=BD?= Date: Tue, 9 Dec 2025 09:59:36 +0100 Subject: [PATCH 08/11] Update sources/platform/integrations/ai/google-adk.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/google-adk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/google-adk.md b/sources/platform/integrations/ai/google-adk.md index 9d38c2f0e..7e0c18c42 100644 --- a/sources/platform/integrations/ai/google-adk.md +++ b/sources/platform/integrations/ai/google-adk.md @@ -22,7 +22,7 @@ For more in-depth details, check out [Google ADK documentation](https://google.g ## How to use Apify with Google ADK -Apify is a marketplace of ready-to-use web scraping and automation tools, AI agents, and MCP servers that you can equip your own AI with. This guide demonstrates how to use Apify tools with a simple AI agent built with Google ADK. +Apify is a marketplace of web scraping and automation tools, AI agents, and MCP servers that you can integrate with your AI agents. This guide shows how to use Apify tools with an AI agent built with Google ADK. ### Prerequisites From 43f1966abcf853eee60f107a82189dd7bbac1d35 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Kopeck=C3=BD?= Date: Tue, 9 Dec 2025 09:59:42 +0100 Subject: [PATCH 09/11] Update sources/platform/integrations/ai/google-adk.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/google-adk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/google-adk.md b/sources/platform/integrations/ai/google-adk.md index 7e0c18c42..5155d042c 100644 --- a/sources/platform/integrations/ai/google-adk.md +++ b/sources/platform/integrations/ai/google-adk.md @@ -16,7 +16,7 @@ slug: /integrations/google-adk :::note Explore Google ADK -For more in-depth details, check out [Google ADK documentation](https://google.github.io/adk-docs/). +For more details, check out [Google ADK documentation](https://google.github.io/adk-docs/). ::: From 6a8644dfab59160f35802411106826464bf32111 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Kopeck=C3=BD?= Date: Tue, 9 Dec 2025 09:59:49 +0100 Subject: [PATCH 10/11] Update sources/platform/integrations/ai/google-adk.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/google-adk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/google-adk.md b/sources/platform/integrations/ai/google-adk.md index 5155d042c..e0e713e19 100644 --- a/sources/platform/integrations/ai/google-adk.md +++ b/sources/platform/integrations/ai/google-adk.md @@ -44,7 +44,7 @@ adk create pub_search_agent Create and configure the agent to use the Apify MCP server tools: -:::warning Required setup +:::warning Set your API token Make sure to set the `APIFY_TOKEN` environment variable in the `.env` file with your Apify API token before running the code. From c1fc02817684ae4635bdf90875d5908dde46874f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Kopeck=C3=BD?= Date: Tue, 9 Dec 2025 12:49:28 +0100 Subject: [PATCH 11/11] Update sources/platform/integrations/ai/google-adk.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/integrations/ai/google-adk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/integrations/ai/google-adk.md b/sources/platform/integrations/ai/google-adk.md index e0e713e19..168c2e04e 100644 --- a/sources/platform/integrations/ai/google-adk.md +++ b/sources/platform/integrations/ai/google-adk.md @@ -1,5 +1,5 @@ --- -title: 🇬 Google ADK integration +title: Google ADK integration sidebar_label: Google ADK description: Learn how to integrate Apify Actors as tools for AI with Google Agent Development Kit (ADK). sidebar_position: 2