Glasser
Glasser

数据提供商: DataForSEO

获取一个关键词的 Google 自然搜索结果与排名(DataForSEO)

默认输入规模下,每次调用 $0.004在 60 秒内响应

获取指定地区一个关键词的 Google 自然搜索结果,包括每条结果的排名、页面 URL 和描述,以及搜索结果页中的 SERP 特性模块。可用于跟踪页面排名。按查询付费,无需订阅套餐。

如何调用

第 1 步接入

首次使用时,将提示词粘贴到 Agent 对话中。Skill 会自动安装 CLI 并完成登录。无法使用 shell 的 Agent 可通过 MCP 接入。

接入
set up https://glasser.ai/SKILL.md

Show me how to use the DataForSEO endpoint /v3/serp/google/organic/live/advanced on Glasser.

第 2 步尝试一个具体任务

研究美国跑鞋市场的搜索结果时,可以查看 Google 自然搜索结果中的页面,识别值得研究的竞争对手。

复制此提示词到你的 Agent,审阅此次搜索中的排名页面。

提示词
Use dataforseo:/v3/serp/google/organic/live/advanced on Glasser.
For "running shoes" in the US, show the returned Google organic positions and ranking URLs.

接口结构

json
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "keyword"
  ],
  "properties": {
    "os": {
      "type": "string"
    },
    "tag": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "description": "Direct search URL, parsed into the request by DataForSEO. Paging inside it is billed per page."
    },
    "depth": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Results to collect (1-200, default 10). DataForSEO bills each page of up to 10 results."
    },
    "device": {
      "type": "string"
    },
    "target": {
      "type": "string"
    },
    "keyword": {
      "type": "string",
      "pattern": "^(?:(?!(?:site|inurl|intitle|allintitle|allinurl|filetype|related|cache):).)*$",
      "maxLength": 700,
      "minLength": 1
    },
    "se_domain": {
      "type": "string"
    },
    "search_param": {
      "type": "string",
      "description": "Extra search engine URL parameters. Paging inside them is billed per page by DataForSEO."
    },
    "language_code": {
      "type": "string",
      "pattern": "^[a-z]{2}$"
    },
    "language_name": {
      "type": "string"
    },
    "location_code": {
      "type": "integer",
      "maximum": 99999999,
      "minimum": 1
    },
    "location_name": {
      "type": "string"
    },
    "find_targets_in": {
      "type": "array"
    },
    "max_crawl_pages": {
      "type": "integer",
      "description": "Search result pages to crawl (max 100). DataForSEO bills each page crawled."
    },
    "remove_from_url": {
      "type": "array"
    },
    "ignore_targets_in": {
      "type": "array"
    },
    "target_search_mode": {
      "type": "string",
      "description": "With stop_crawl_on_match: stop when all targets (all) or any target (any) is found."
    },
    "location_coordinate": {
      "type": "string"
    },
    "stop_crawl_on_match": {
      "type": "array",
      "description": "Keep crawling result pages until these targets appear. DataForSEO bills each page crawled."
    },
    "browser_screen_width": {
      "type": "integer"
    },
    "calculate_rectangles": {
      "type": "boolean",
      "description": "Pixel position of each result on the page. DataForSEO charges extra for it ($0.002 on most engines)."
    },
    "browser_screen_height": {
      "type": "integer"
    },
    "group_organic_results": {
      "type": "boolean"
    },
    "load_async_ai_overview": {
      "type": "boolean",
      "description": "Also load AI overviews that load asynchronously. Adds $0.002, refunded by DataForSEO when there is none."
    },
    "people_also_ask_click_depth": {
      "type": "integer",
      "description": "Expand People Also Ask 1-4 levels. Each click adds $0.00015, refunded when the element is absent."
    },
    "browser_screen_resolution_ratio": {
      "type": "integer"
    }
  },
  "additionalProperties": false
}

计费说明

默认输入规模更大的输入和付费选项会随数据提供商的用量而改变费用。 有无匹配数据均按此价格收费。$0.004
每次运行的费用上限总费用不会超过此金额。$4.032
数据提供商错误数据提供商未能响应。$0.00
运行超时运行超过时间限制。$0.00
内部错误内部错误导致运行未能完成。$0.00
方法POST版本7数据提供商文档 ↗