> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# أداة بحث Google عبر SerpApi

> أداة `SerpApiGoogleSearchTool` تنفذ عمليات بحث Google باستخدام خدمة SerpApi.

# `SerpApiGoogleSearchTool`

## الوصف

استخدم `SerpApiGoogleSearchTool` لتشغيل عمليات بحث Google باستخدام SerpApi واسترجاع نتائج منظمة. يتطلب مفتاح SerpApi API.

## التثبيت

```shell theme={null}
uv add crewai-tools[serpapi]
```

## متغيرات البيئة

* `SERPAPI_API_KEY` (مطلوب): مفتاح API لـ SerpApi. أنشئ واحداً على [https://serpapi.com/](https://serpapi.com/) (طبقة مجانية متاحة).

## مثال

```python Code theme={null}
from crewai import Agent, Task, Crew
from crewai_tools import SerpApiGoogleSearchTool

tool = SerpApiGoogleSearchTool()

agent = Agent(
    role="Researcher",
    goal="Answer questions using Google search",
    backstory="Search specialist",
    tools=[tool],
    verbose=True,
)

task = Task(
    description="Search for the latest CrewAI releases",
    expected_output="A concise list of relevant results with titles and links",
    agent=agent,
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
```

## ملاحظات

* عيّن `SERPAPI_API_KEY` في البيئة. أنشئ مفتاحاً على [https://serpapi.com/](https://serpapi.com/)
* انظر أيضاً Google Shopping عبر SerpApi: `/ar/tools/search-research/serpapi-googleshoppingtool`

## المعاملات

### معاملات التشغيل

* `search_query` (str، مطلوب): استعلام Google.
* `location` (str، اختياري): معامل الموقع الجغرافي.

## ملاحظات

* هذه الأداة تغلّف SerpApi وتُرجع نتائج بحث منظمة.