SerpApi 搜索引擎结果抓取 API - 支持 Google、Bing、YouTube 等，助力 SEO 分析与数据获取

serpapi by vm0-ai/vm0-skills

221 周安装量

52 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/vm0-ai/vm0-skills --skill serpapi

数据分析 SEO API

🇨🇳中文介绍

SerpApi

通过直接调用 curl 来使用 SerpApi，以抓取搜索引擎结果，支持 Google、Bing、YouTube 等。

官方文档：https://serpapi.com/search-api

使用时机

在以下场景中使用此技能：

抓取 Google 搜索结果（自然结果、广告、知识图谱）
搜索 Google 图片、新闻、视频、购物
从 Google 地图获取本地商家结果
抓取其他搜索引擎（Bing、YouTube、DuckDuckGo 等）
监控搜索结果页面排名以进行 SEO 分析

先决条件

在 SerpApi 注册
前往仪表板并复制您的 API 密钥
将其存储在环境变量 SERPAPI_TOKEN 中

export SERPAPI_TOKEN="your-api-key"

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

1. 基础 Google 搜索

搜索 Google 并获取结构化的 JSON 结果：

curl -s "https://serpapi.com/search?engine=google&q=artificial+intelligence&api_key=$(printenv SERPAPI_TOKEN)" | jq '.organic_results[:3] | .[] | {title, link, snippet}'

2. 按地理位置搜索

从特定地理位置进行搜索：

curl -s "https://serpapi.com/search?engine=google&q=best+coffee+shops&location=San+Francisco,+California&gl=us&hl=en&api_key=$(printenv SERPAPI_TOKEN)" | jq '.organic_results[:3]'

location：城市、州或地址
gl：国家代码（us、uk、de 等）
hl：语言代码（en、de、fr 等）

3. Google 图片搜索

curl -s "https://serpapi.com/search?engine=google_images&q=sunset+beach&api_key=$(printenv SERPAPI_TOKEN)" | jq '.images_results[:3] | .[] | {title, original, thumbnail}'

4. Google 新闻搜索

搜索新闻文章：

curl -s "https://serpapi.com/search?engine=google_news&q=technology&api_key=$(printenv SERPAPI_TOKEN)" | jq '.news_results[:3] | .[] | {title, link, source, date}'

5. Google 购物搜索

curl -s "https://serpapi.com/search?engine=google_shopping&q=wireless+headphones&api_key=$(printenv SERPAPI_TOKEN)" | jq '.shopping_results[:3] | .[] | {title, price, source}'

搜索 YouTube 视频：

curl -s "https://serpapi.com/search?engine=youtube&search_query=python+tutorial&api_key=$(printenv SERPAPI_TOKEN)" | jq '.video_results[:3] | .[] | {title, link, channel, views}'

7. Google 地图 / 本地结果

搜索本地商家：

curl -s "https://serpapi.com/search?engine=google_maps&q=restaurants&ll=@40.7128,-74.0060,15z&api_key=$(printenv SERPAPI_TOKEN)" | jq '.local_results[:3] | .[] | {title, rating, address}'

如果在 Google 地图中使用 location，请包含 z 或 m：

curl -s "https://serpapi.com/search?engine=google_maps&q=3PL&location=Dallas-Fort+Worth,+Texas&z=14&api_key=$(printenv SERPAPI_TOKEN)"

防御性的本地结果提取：

curl -s "https://serpapi.com/search?engine=google_maps&q=3PL&ll=@32.7767,-96.7970,14z&api_key=$(printenv SERPAPI_TOKEN)" \
  | jq 'if has("error") then .error else (.local_results[:5] | map({title,address,phone,website,link,type})) end'

ll：纬度、经度和缩放级别（例如 @40.7128,-74.0060,15z）

使用 start 参数获取更多结果：

# 第一页（结果 1-10）
curl -s "https://serpapi.com/search?engine=google&q=machine+learning&start=0&api_key=$(printenv SERPAPI_TOKEN)" | jq '.organic_results | length'

# 第二页（结果 11-20）
curl -s "https://serpapi.com/search?engine=google&q=machine+learning&start=10&api_key=$(printenv SERPAPI_TOKEN)" | jq '.organic_results | length'

9. 检查账户信息

检查您的 API 使用情况和额度：

curl -s "https://serpapi.com/account?api_key=$(printenv SERPAPI_TOKEN)" | jq '{plan_name, searches_per_month, this_month_usage}'

支持的搜索引擎

搜索引擎	参数	描述
Google 搜索	`engine=google`	网页搜索结果
Google 图片	`engine=google_images`	图片搜索
Google 新闻	`engine=google_news`	新闻文章
Google 购物	`engine=google_shopping`	产品搜索
Google 地图	`engine=google_maps`	本地商家
YouTube	`engine=youtube`	视频搜索
Bing	`engine=bing`	Bing 网页搜索
DuckDuckGo	`engine=duckduckgo`	注重隐私的搜索

参数	描述
`q`	搜索查询（必需）
`engine`	使用的搜索引擎
`location`	搜索的地理位置
`gl`	国家代码（例如 us、uk）
`hl`	语言代码（例如 en、de）
`start`	分页偏移量（0、10、20...）
`num`	结果数量（最多 100）
`safe`	安全搜索（`active` 或 `off`）
`device`	设备类型（`desktop`、`mobile`、`tablet`）

使用特定的搜索引擎：使用 google_images、google_news 等，而不是 tbm 参数，以获得更清晰的结果
为本地搜索添加地理位置：使用 location 和 gl 获取地理定位结果
缓存结果：SerpApi 默认缓存结果；使用 no_cache=true 获取最新数据
监控使用情况：检查 /account 端点以跟踪 API 额度
使用 jq 过滤器：过滤大型 JSON 响应，仅提取所需数据

🇺🇸English

SerpApi

Use SerpApi via direct curl calls to scrape search engine results from Google, Bing, YouTube, and more.

Official docs: https://serpapi.com/search-api

When to Use

Use this skill when you need to:

Scrape Google search results (organic, ads, knowledge graph)
Search Google Images, News, Videos, Shopping
Get local business results from Google Maps
Scrape other search engines (Bing, YouTube, DuckDuckGo, etc.)
Monitor SERP rankings for SEO analysis

Prerequisites

Sign up at SerpApi
Go to Dashboard and copy your API key
Store it in the environment variable SERPAPI_TOKEN

export SERPAPI_TOKEN="your-api-key"

Pricing

Free tier: 100 searches/month
API key is passed as a query parameter api_key

How to Use

All examples below assume you have SERPAPI_TOKEN set.

Base URL: https://serpapi.com/search

1. Basic Google Search

Search Google and get structured JSON results:

curl -s "https://serpapi.com/search?engine=google&q=artificial+intelligence&api_key=$(printenv SERPAPI_TOKEN)" | jq '.organic_results[:3] | .[] | {title, link, snippet}'

2. Search with Location

Search from a specific location:

curl -s "https://serpapi.com/search?engine=google&q=best+coffee+shops&location=San+Francisco,+California&gl=us&hl=en&api_key=$(printenv SERPAPI_TOKEN)" | jq '.organic_results[:3]'

Parameters:

location: City, state, or address
gl: Country code (us, uk, de, etc.)
hl: Language code (en, de, fr, etc.)

3. Google Image Search

Search for images:

curl -s "https://serpapi.com/search?engine=google_images&q=sunset+beach&api_key=$(printenv SERPAPI_TOKEN)" | jq '.images_results[:3] | .[] | {title, original, thumbnail}'

4. Google News Search

Search news articles:

curl -s "https://serpapi.com/search?engine=google_news&q=technology&api_key=$(printenv SERPAPI_TOKEN)" | jq '.news_results[:3] | .[] | {title, link, source, date}'

5. Google Shopping Search

Search products:

curl -s "https://serpapi.com/search?engine=google_shopping&q=wireless+headphones&api_key=$(printenv SERPAPI_TOKEN)" | jq '.shopping_results[:3] | .[] | {title, price, source}'

6. YouTube Search

Search YouTube videos:

curl -s "https://serpapi.com/search?engine=youtube&search_query=python+tutorial&api_key=$(printenv SERPAPI_TOKEN)" | jq '.video_results[:3] | .[] | {title, link, channel, views}'

7. Google Maps / Local Results

Search local businesses:

curl -s "https://serpapi.com/search?engine=google_maps&q=restaurants&ll=@40.7128,-74.0060,15z&api_key=$(printenv SERPAPI_TOKEN)" | jq '.local_results[:3] | .[] | {title, rating, address}'

If using location with Google Maps, include z or m:

curl -s "https://serpapi.com/search?engine=google_maps&q=3PL&location=Dallas-Fort+Worth,+Texas&z=14&api_key=$(printenv SERPAPI_TOKEN)"

Defensive local-results extraction:

curl -s "https://serpapi.com/search?engine=google_maps&q=3PL&ll=@32.7767,-96.7970,14z&api_key=$(printenv SERPAPI_TOKEN)" \
  | jq 'if has("error") then .error else (.local_results[:5] | map({title,address,phone,website,link,type})) end'

Parameters:

ll: Latitude, longitude, and zoom level (e.g., @40.7128,-74.0060,15z)

8. Pagination

Get more results using the start parameter:

# First page (results 1-10)
curl -s "https://serpapi.com/search?engine=google&q=machine+learning&start=0&api_key=$(printenv SERPAPI_TOKEN)" | jq '.organic_results | length'

# Second page (results 11-20)
curl -s "https://serpapi.com/search?engine=google&q=machine+learning&start=10&api_key=$(printenv SERPAPI_TOKEN)" | jq '.organic_results | length'

9. Check Account Info

Check your API usage and credits:

curl -s "https://serpapi.com/account?api_key=$(printenv SERPAPI_TOKEN)" | jq '{plan_name, searches_per_month, this_month_usage}'

Supported Engines

Engine	Parameter	Description
Google Search	`engine=google`	Web search results
Google Images	`engine=google_images`	Image search
Google News	`engine=google_news`	News articles
Google Shopping	`engine=google_shopping`	Product search
Google Maps	`engine=google_maps`

Common Parameters

Parameter	Description
`q`	Search query (required)
`engine`	Search engine to use
`location`	Geographic location for search
`gl`	Country code (e.g., us, uk)
`hl`	Language code (e.g., en, de)
`start`	Pagination offset (0, 10, 20...)

Guidelines

Use specific engines : Use google_images, google_news etc. instead of tbm parameter for cleaner results
Add location for local searches : Use location and gl for geo-targeted results
Cache results : SerpApi caches results by default; use no_cache=true for fresh data
Monitor usage : Check /account endpoint to track API credits
Use jq filters : Filter large JSON responses to extract only needed data

Weekly Installs

194

Repository

vm0-ai/vm0-skills

GitHub Stars

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

codex167

gemini-cli159

opencode158

github-copilot153

cursor153

amp150

DOCX文件创建、编辑与分析完整指南 - 使用docx-js、Pandoc和Python脚本

49,900 周安装

SerpApi 搜索引擎结果抓取 API - 支持 Google、Bing、YouTube 等，助力 SEO 分析与数据获取

🇨🇳中文介绍

SerpApi

使用时机

先决条件

相关 Skills

定价

使用方法

1. 基础 Google 搜索

2. 按地理位置搜索

3. Google 图片搜索

4. Google 新闻搜索

5. Google 购物搜索

6. YouTube 搜索

7. Google 地图 / 本地结果

8. 分页

9. 检查账户信息

支持的搜索引擎

常用参数

指南

🇺🇸English

SerpApi

When to Use

Prerequisites

Pricing

How to Use

1. Basic Google Search

2. Search with Location

3. Google Image Search

4. Google News Search

5. Google Shopping Search

6. YouTube Search

7. Google Maps / Local Results

8. Pagination

9. Check Account Info

Supported Engines

Common Parameters

Guidelines

最新 Skills