用途:该技能面向需要与 SafeGraph 数据交互的用户,用于管理数据、记录并自动化工作流。SafeGraph 提供高精度兴趣点(POI)数据、建筑轮廓数据与人口统计洞察,常被数据科学家、研究人员和分析师用于市场研究、城市规划和房地产分析。官方文档位于 https://docs.safegraph.com/。
主要能力:可围绕 Places、Geometry、Patterns、Brands、POI 等资源进行操作。技能通过 Membrane CLI 与 SafeGraph 通信,Membrane 自动处理认证与凭证刷新。
安装与认证:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>。无头环境会打印授权 URL,需用户在浏览器打开,完成后执行 membrane login complete <code>。任意命令加 --json 可获得机器可读输出。
连接:membrane connection ensure "https://www.safegraph.com/" --json,用户在浏览器完成认证,输出包含连接 id。若状态为 BUILDING,可用 npx @membranehq/cli connection get <id> --wait --json 轮询直至 READY;如为 CLIENT_ACTION_REQUIRED,按 clientAction 提示操作。
查找与运行动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json;运行:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}',结果在 output 字段。
代理请求:当预建动作不覆盖需求时,可经代理直接请求 SafeGraph API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
限制:具体可用动作、参数与返回结构需通过命令实际查询获得,资料未提供固定清单;API 状态、配额、费用与计费方式暂未提供;使用前需完成认证与连接。