如果 AI 概述回答其上方的查询，排名第一的页面可以获得零点击。搜索表面监控跟踪每个 SERP 功能：AI 概述、PAA 框、片段、知识面板和本地包。当功能发生变化时，即使排名保持不变，您的可见度也会发生变化。本教程以 0.005 美元/关键字的价格构建一个 Surface 监视器。
前置条件
- Python 3.8+
- 请求库
- 来自 scavio.dev 的 Scavio API 密钥
- 要监控的关键字
操作指南
步骤 1: 捕获完整的 SERP 表面
解析每个关键字的所有特征类型。
Python
import os, requests, json
from datetime import date
API_KEY = os.environ['SCAVIO_API_KEY']
H = {'x-api-key': API_KEY, 'Content-Type': 'application/json'}
DOMAIN = 'mysite.com'
KEYWORDS = ['serp api python', 'web scraping api 2026', 'tiktok data api']
def capture(keyword):
data = requests.post('https://api.scavio.dev/api/v1/search',
headers=H, json={'query': keyword, 'country_code': 'us'}).json()
features = {}
if data.get('answer_box'): features['answer_box'] = True
if data.get('ai_overview'): features['ai_overview'] = True
if data.get('related_questions'): features['paa'] = len(data['related_questions'])
if data.get('knowledge_graph'): features['kg'] = True
pos = next((r['position'] for r in data.get('organic_results', []) if DOMAIN in r.get('link', '')), None)
return {'keyword': keyword, 'date': date.today().isoformat(), 'features': features, 'position': pos}步骤 2: 与之前的快照进行比较
检测特征何时出现或消失。
Python
def detect_changes(current, previous):
if not previous: return ['NEW: first capture']
changes = []
curr_f = set(current['features'])
prev_f = set(previous.get('features', {}))
for f in curr_f - prev_f: changes.append(f'ADDED: {f}')
for f in prev_f - curr_f: changes.append(f'REMOVED: {f}')
cp, pp = current.get('position'), previous.get('position')
if cp and pp and cp != pp: changes.append(f'RANK: {pp} -> {cp}')
return changes步骤 3: 运行监视器
捕获、比较和保存状态。
Python
def run_monitor():
try:
with open('surface.json') as f: prev = {e['keyword']: e for line in f for e in [json.loads(line)]}
except FileNotFoundError: prev = {}
surfaces = []
for kw in KEYWORDS:
s = capture(kw)
surfaces.append(s)
changes = detect_changes(s, prev.get(kw))
feats = ', '.join(s['features']) or 'organic only'
print(f' {kw}: pos={s["position"] or "N/A"}, [{feats}]')
for c in changes: print(f' {c}')
with open('surface.json', 'w') as f:
for s in surfaces: f.write(json.dumps(s) + '\n')
print(f'Cost: ${len(KEYWORDS) * 0.005:.3f}')
run_monitor()步骤 4: 计算可见度分数
估计 SERP 功能的点击率影响。
Python
def visibility(surface):
pos = surface.get('position')
if not pos: return 0.0
base = {1: 0.30, 2: 0.15, 3: 0.10, 4: 0.07, 5: 0.05}.get(pos, 0.02)
if 'ai_overview' in surface.get('features', {}): base *= 0.5
if 'answer_box' in surface.get('features', {}): base *= 0.7
return round(base, 4)
for kw in KEYWORDS:
s = capture(kw)
v = visibility(s)
print(f' {kw}: pos={s["position"]}, visibility={v:.2%}')Python 示例
Python
import os, requests
API_KEY = os.environ['SCAVIO_API_KEY']
H = {'x-api-key': API_KEY, 'Content-Type': 'application/json'}
def check(kw, domain):
data = requests.post('https://api.scavio.dev/api/v1/search',
headers=H, json={'query': kw, 'country_code': 'us'}).json()
features = [k for k in ['answer_box', 'ai_overview', 'related_questions', 'knowledge_graph'] if data.get(k)]
pos = next((r['position'] for r in data.get('organic_results', []) if domain in r.get('link', '')), None)
print(f'{kw}: pos={pos or "N/A"}, features={features}')
check('serp api python', 'mysite.com')JavaScript 示例
JavaScript
const API_KEY = process.env.SCAVIO_API_KEY;
const H = { 'x-api-key': API_KEY, 'Content-Type': 'application/json' };
async function check(kw, domain) {
const data = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST', headers: H, body: JSON.stringify({ query: kw, country_code: 'us' })
}).then(r => r.json());
const features = ['answer_box', 'ai_overview', 'related_questions'].filter(k => data[k]);
const match = (data.organic_results || []).find(r => r.link.includes(domain));
console.log(`${kw}: pos=${match?.position||'N/A'}, features=[${features}]`);
}
check('serp api python', 'mysite.com').catch(console.error);预期输出
JSON
serp api python: pos=4, [paa]
web scraping api 2026: pos=7, [ai_overview, paa, answer_box]
ADDED: ai_overview
RANK: 5 -> 7
tiktok data api: pos=2, [paa]
Cost: $0.015