用途：针对指定连锁品牌与地理边界，梳理并比对已观测到的门店覆盖，比较不同数据源（Crawlora 星巴克目录、实时连锁定位器、Google Maps 商户记录）。该分析描述的是观测到的供给，不代表销量、客流、需求或选址盈利性。
用法：设置 CRAWLORA_API_KEY。连接时优先使用 Crawlora MCP 工具，否则使用 scripts/crawlora.sh，它向 https://api.crawlora.net/api/v1 发送 x-api-key。具体方法与参数见 reference/endpoints.md。需检查应用代码与 HTTP 状态，载荷位于 data 内；遇认证错误停止，429 退避，瞬时上游失败重试一次，并按范围与额度限制调用/分页。分别保留来源 ID、URL、来源日期与观测/抓取时间。
主要能力：在匹配的地理范围内发现门店；用已存星巴克 facets/search/nearby 做品牌发现并保留 store_number；用实时 locator/nearest-store 刷新选定位置（需地名或坐标，无分页上限为 50，result_capped 表示本地结果不完整，并区分 place_not_found 与无门店返回）。其他品牌可用 Google Maps 商户搜索/筛选/附近及实时验证，注意名称文本匹配不等于已核实连锁归属。麦当劳坐标定位器为独立来源，其半径单位为英里，而数据集 nearby 半径单位为米，须换算。
示例命令：scripts/crawlora.sh /datasets/starbucks-stores/facets facet=country；scripts/crawlora.sh /datasets/starbucks-stores/search country=US city=Seattle page=1 page_size=100；scripts/crawlora.sh /starbucks/stores place="Seattle, WA" market=us；scripts/crawlora.sh /datasets/google-map-businesses/search q="Starbucks" city=Seattle page=1 page_size=10。
限制：已存索引不等于官方门店普查，也不能证明竞品不存在。需先按品牌/门店 ID 去重，跨源匹配需地址与坐标佐证；相似名称不充分，同一综合体两个单元可为不同门店。空排班/设施字段可能只表示该市场未发布，而非关闭。重叠半径查询按唯一门店计数，不可用圆面积之和计算密度；人均指标需单独来源的人口数据。历史扩张/收缩结论需可比的留存观测与已核实变化。本工具不联系门店、不提交线索，也不应仅据此选择投资或选址。