Google Trends (via Apify)

io.github.retracnv1.0.0更新於 Oct 3, 2026

Google Trends data for AI agents: interest over time, regions, rising queries and trending searches.

已驗證Streamable HTTP可網頁執行Web Search & ScrapingData & Analytics

概覽

AI 產生的概覽

讓助理透過 Apify 代管的 MCP 伺服器取得 Google Trends 資料,包括熱度走勢、地區分布、相關與竄升查詢以及熱門搜尋。

功能
包裝了一個 Apify Actor,可依關鍵字與地區擷取 Google Trends 資料。每個關鍵字回傳一列結果,包含 0–100 的熱度時間軸、趨勢方向、變化百分比、高峰日期、一句話摘要、依國家/州/城市的興趣分布,以及附成長百分比的熱門與竄升相關查詢。也會回傳某個國家/地區的目前熱門搜尋,含搜尋量、成長、開始時間、相關搜尋與新聞文章,並支援把多個詞放在同一尺度上比較。
適用情境
適合需要即時搜尋熱度訊號的情境:比較品牌或話題熱度、查看地區需求、找出竄升查詢,或監控某個國家/地區的熱門搜尋。適用於研究、行銷與內容規劃類問題,此時即時 Google Trends 資料比模型記憶更可靠。
執行需求
遠端 MCP 端點 mcp.apify.com,透過 streamable HTTP 存取。需要 Apify API 權杖,以 Bearer 形式放在 Authorization 標頭中;免費 Apify 帳號即可取得。需要能連線至 Apify 的網路,並依報告量計費。
安裝前請注意
Authorization 標頭帶有 Apify API 權杖,應視為機密,避免出現在共用設定或日誌中。執行需付費:約每 1,000 份關鍵字報告 1 美元、每 1,000 次熱門搜尋 0.50 美元,從 Apify 額度扣除,重複或排程呼叫會持續花錢。關鍵字輸入與結果在 Apify 平台上處理,而非本機。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Google Trends (via Apify),將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "google-trends": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=automationnation/google-trends-scraper"
    }
  }
}

README

Google Trends Scraper & API: keyword trends and Trending now

[Run on Apify]

Google Trends Scraper is an Apify Actor that extracts Google Trends data for any keywords and regions — interest over time, interest by region and city, rising and top related queries, and the trending searches for any country — at $1 per 1,000 keyword reports. It works as a Google Trends API: call it from code, schedule it for trend alerts, or let AI agents use it through Apify's MCP server.

Price: $1 per 1,000 keyword reports ($0.27–$0.90 on paid plans) · $0.50 per 1,000 trending searches · Run it: https://apify.com/automationnation/google-trends-scraper · Guide: https://retracn.github.io/automationnation-actors/google-trends-scraper/

Quick facts

  • One row per keyword: the 0–100 timeline with dates, trend direction and change %, peak date, a one-sentence summary, interest by country / state / city, and top and rising related queries with growth % and Breakout flags.
  • Trending now for any country: search volume, growth %, start time, related searches and news articles; Only new trends mode turns scheduled runs into alerts.
  • Compare up to 5 terms like Google Trends, or any number of terms on one scale (rescaled through a shared anchor term).
  • Every Google Trends option: any country or subregion, past hour to 2004–present or custom dates, category, and web / image / news / YouTube / Shopping search; input as keywords, Google Trends URLs or a Google Sheet.
  • Price: $1 per 1,000 keyword reports and $0.50 per 1,000 trending searches on the Free plan (lower on paid plans); keywords with too little search volume are free. Apify's free $5 monthly credit covers about 5,000 keyword reports.
  • Same input fields as apify/google-trends-scraper, and every row also includes that Actor's output fields.

Example input

json
{  "searchTerms": [    "chatgpt",    "gemini",    "claude ai"  ],  "geo": "US",  "timeRange": "today 12-m"}

Run it from code

REST API

bash
curl -X POST "https://api.apify.com/v2/acts/automationnation~google-trends-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \  -H "Content-Type: application/json" \  -d '{"searchTerms": ["chatgpt", "gemini", "claude ai"], "geo": "US", "timeRange": "today 12-m"}'

Python — see examples/python_example.py

python
# pip install apify-clientfrom apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")run = client.actor("automationnation/google-trends-scraper").call(run_input={  "searchTerms": [    "chatgpt",    "gemini",    "claude ai"  ],  "geo": "US",  "timeRange": "today 12-m"})for item in client.dataset(run["defaultDatasetId"]).iterate_items():    print(item.get("searchTerm"), item.get("trendDirection"), item.get("changePercent"), item.get("summary"))

JavaScript — see examples/node_example.mjs

js
// npm install apify-clientimport { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });const run = await client.actor('automationnation/google-trends-scraper').call({  "searchTerms": [    "chatgpt",    "gemini",    "claude ai"  ],  "geo": "US",  "timeRange": "today 12-m"});const { items } = await client.dataset(run.defaultDatasetId).listItems();for (const item of items) console.log(item.searchTerm, item.trendDirection, item.changePercent, item.summary);

Use it with AI agents (MCP)

Hosted MCP server URL (Claude, ChatGPT, Cursor and other clients with remote MCP support):

https://mcp.apify.com?tools=automationnation/google-trends-scraper

Local config for Claude Desktop / Cursor — mcp/claude_desktop_config.json:

json
{  "mcpServers": {    "google-trends-scraper": {      "command": "npx",      "args": [        "-y",        "@apify/actors-mcp-server",        "--tools",        "automationnation/google-trends-scraper"      ],      "env": {        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"      }    }  }}

FAQ

Is there an official Google Trends API? Google opened an official Google Trends API to a small group of alpha testers in 2025. For everyone else, Google Trends Scraper on Apify provides Google Trends data through Apify's REST API, Python and JavaScript clients, integrations and MCP.

What does Google Trends Scraper return? For each keyword: interest over time (0–100 with dates), trend direction, change %, peak date, a one-sentence summary, interest by region and city, and top and rising related queries. Trending now rows include search volume, growth %, start time, related searches and news articles.

Can it compare more than 5 keywords? Yes. With Compare all search terms on one scale, terms are batched around a shared anchor term and rescaled so any number of terms sit on one 0–100 scale.

How much does it cost? $1 per 1,000 keyword reports and $0.50 per 1,000 trending searches on Apify's Free plan, less on paid plans. Keywords without enough search volume and failed searches are free.

Can I switch from apify/google-trends-scraper? Yes. Keep your input (searchTerms, isMultiple, timeRange, customTimeRange, geo, category, startUrls, spreadsheetId, maxItems) and change the Actor ID; rows keep that Actor's field names next to the cleaner ones.

More from AutomationNation


This repository holds usage examples. The scraper itself runs on the Apify platform; you need a free Apify account and API token. Examples are MIT licensed.

來源:README.md,提交 85ed3fe

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v1.0.0最新Oct 3, 2026