docs: add google adk integration

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)