> ## 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

> أداة `SerpApiGoogleShoppingTool` تبحث في نتائج Google Shopping باستخدام SerpApi.

# `SerpApiGoogleShoppingTool`

## الوصف

استفد من `SerpApiGoogleShoppingTool` للاستعلام من Google Shopping عبر SerpApi واسترجاع نتائج موجّهة للمنتجات.

## التثبيت

```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 SerpApiGoogleShoppingTool

tool = SerpApiGoogleShoppingTool()

agent = Agent(
    role="Shopping Researcher",
    goal="Find relevant products",
    backstory="Expert in product search",
    tools=[tool],
    verbose=True,
)

task = Task(
    description="Search Google Shopping for 'wireless noise-canceling headphones'",
    expected_output="Top relevant products 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 على الويب عبر SerpApi: `/ar/tools/search-research/serpapi-googlesearchtool`

## المعاملات

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

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