SearchCans 市场观察
为一个查询和一个市场建立可追溯的市场快照。默认获取 Google 网页、Google News 与 Bing 结果,再读取数量严格受限、域名尽量多样且可用的新闻页面。它是按需运行的快照,不是后台监测或告警服务。
先定义市场问题
确认查询、country、language、业务问题,以及是否需要与既有 JSON 快照比较。若市场选择会实质改变结论,不得擅自假设。
仅在执行环境中设置 SEARCHCANS_API_KEY;不得将 Key 写入提示词、源码、产物或提交。
python scripts/market_watch.py "AI 搜索 API" \
--country us --language zh --max-source-reads 3 \
--out market-watch.json
仅当 Google 双搜索面已足够时使用 --without-bing。使用 --baseline prior-market-watch.json 时,只报告新观察到或不再观察到的 URL;这不等同于页面新发布、删除或不可访问。
让账户决定安全范围
默认的 --account-mode auto 发起一次脱敏的 Account API 预检,估算三次 SERP 调用和所请求 Reader 调用,并在可行时只收缩 Reader 范围;并行数不超过账户报告的 Parallel Lane 数。
auto:按可用预算收缩 Reader 来源数。enforce:预算不足时在业务请求前停止。warn:保留范围,但记录预算警告。off:跳过预检。
输出仅保留安全的预算摘要,不写入账户身份或 Key。从 --proxy 0 开始;更高代理档位会改变 Reader 成本,只能用于已确认的访问问题。
正确解释证据
将 google_news.results 视为标题和发布时间元数据,将 news_source_quality 视为候选接受/拒绝状态,将 read_sources 视为更完整的页面证据。只有 Reader 成功返回内容的 URL 才会进入 claim_eligible_urls。
只有标题和发布者非空、URL 有效且不是 Google 占位页、并通过质量检查的候选才可交给 Reader。若 news_source_quality.status 为 no_usable_news_sources,应报告该市场和查询在 News 搜索面没有可用的新闻文章证据;不得重试被拒绝的占位 URL,也不得将其写成新闻事实。
使用 报告模板 输出:
- 市场/查询定义和准确检索时间。
- 按搜索面分开的网页与新闻观察。
- 每项确认发展及其 Reader URL。
- 跨引擎差异、未解决问题和下一次运行建议。
SERP 标题、摘要、日期和排名仅是发现线索,不能单独证明事实、品牌定位、新闻重要性或商业影响。
官网
资源
scripts/market_watch.py:生成有界 JSON 证据包。references/market-watch-report.md:报告结构和主张边界。