io.serpjet/serpjet-mcp
Google SERP API for AI agents. 10 result types incl. shopping. 1,000 free searches/month.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
serpjet-mcpclaude mcp add serpjet-mcp -e 'SERPJET_API_KEY=<your serpjet_api_key>' -- npx -y serpjet-mcp@0.1.1
{
"mcpServers": {
"serpjet-mcp": {
"command": "npx",
"args": [
"-y",
"serpjet-mcp@0.1.1"
],
"env": {
"SERPJET_API_KEY": "<your serpjet_api_key>"
}
}
}
}
متغيرات البيئة
SERPJET_API_KEYإلزامي سري API key from https://serpjet.io/signup (free tier: 1,000 searches/month)
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
SERPJET MCP Server
Give your AI agent Google Search. 1,000 free searches/month — recurring, no credit card.
An MCP (Model Context Protocol) server for SERPJET — a Google SERP API that returns clean, structured JSON for 10 result types: web search, images, videos, news, shopping (with prices), maps, places, scholar, patents, and autocomplete.
Why SERPJET
- 1,000 searches/month free, forever — quota resets monthly (not a one-time trial credit)
- No credit card required — sign up with just an email
- 10 result types in one tool, including Google Shopping with price fields
- Country targeting via
glparameter (us,de,jp, ...) - Paid plans from $5, billed per successful request only
Quick start
- Get a free API key at serpjet.io/signup
- Add to your MCP client config:
Claude Desktop / Claude Code
{
"mcpServers": {
"serpjet": {
"command": "npx",
"args": ["-y", "serpjet-mcp"],
"env": {
"SERPJET_API_KEY": "sj_your_key_here"
}
}
}
}
Cursor / Windsurf
Same config shape — add the serpjet entry to your MCP settings with SERPJET_API_KEY in env.
Tool
google_search
| Parameter | Type | Description |
|---|---|---|
q | string (required) | Search query |
type | enum | search (default), images, videos, news, shopping, maps, places, scholar, patents, autocomplete |
gl | string | Country code for geo-targeting, e.g. us, de, jp |
hl | string | Language, e.g. en, zh-cn |
num | number | Number of results (1–100) |
page | number | Result page |
Returns the raw SERPJET JSON response. Example — ask your agent:
"What does an Anker 20000mAh power bank cost right now in the US?"
The agent calls google_search with {"q": "anker 20000mah power bank", "type": "shopping", "gl": "us"} and gets back 40 offers with live prices and sellers.
Environment variables
| Variable | Required | Description |
|---|---|---|
SERPJET_API_KEY | yes | Your API key from serpjet.io |
SERPJET_API_BASE | no | Override API base URL (default https://api.serpjet.io) |
Links
License
MIT
الأسئلة الشائعة
ما هو io.serpjet/serpjet-mcp؟
Google SERP API for AI agents. 10 result types incl. shopping. 1,000 free searches/month.
كيف أثبّت io.serpjet/serpjet-mcp؟
يعمل على جهازك. في Claude Code: claude mcp add serpjet-mcp -e 'SERPJET_API_KEY=<your serpjet_api_key>' -- npx -y serpjet-mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.serpjet/serpjet-mcp إلى مفتاح API؟
نعم. يتطلب SERPJET_API_KEY، وتضبطها في إعداداته.
هل io.serpjet/serpjet-mcp مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون io.serpjet/serpjet-mcp؟
ينشره jibaoproxyofficial-pixel. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.