用途
find-engineering-firm 是一个通过 ServiceGraph API 操作的技能,用于查找、筛选、核实并补全美国实体工程公司(涉及建筑、基础设施、能源、制造等领域),数据来自 pro_services 数据集。该技能明确不适用于软件工程:"software engineering firm"、"engineering team"、招聘"engineering manager"、系统架构评审等均属软件开发者范畴,应转交 find-software-developer。技能的第一步就是确认用户指的是实体工程而非软件。
主要能力
- 数据集固定使用 industry:engineering_services 标签(注意后缀为 _services,资料指出旧文档中的 industry:engineering 在实际目录中返回零结果)。
- 服务子类以 service_provided 标签表示,约23个,例如 civil-engineering、structural-engineering、mep-engineering、mechanical-engineering、electrical-engineering、geotechnical-engineering、surveying-mapping(不是 surveying)、transportation-engineering、environmental-engineering、manufacturing-engineering、aerospace-engineering、energy-engineering、industrial-automation、materials-testing、acoustic-engineering、biomedical-engineering 等;确切名称需通过 /v1/datasets/pro_services/fields?include_values=1 确认。
- 行业垂直场景(医院、高层、半导体、零售、数据中心)和资质(PE 执照、LEED、AICP)仅能作为关键词使用。
- 公司以 apex 域名标识(如 aecom.com,而非带路径的网址)。
使用方式
整体流程先免费后付费:发现、校验、搜索和简要读取免费;只有用户明确确认花费后才解锁。
- 选择调用路径:优先使用环境中已加载的 ServiceGraph MCP 服务器工具(通过 OAuth 2.1 + PKCE 将令牌保存在沙箱内),否则走 REST。
- GET /v1/datasets/pro_services/fields?include_values=1 确认字段和取值。
- 构造过滤条件并用 GET /v1/datasets/pro_services/check 校验,或通过 POST /v1/datasets/pro_services/translate-intent 将自然语言转为 DSL。
- GET /v1/datasets/pro_services/search 获取免费简要卡片并让用户挑选。
- 告知解锁费用(每行10积分,30天有效期)并取得明确同意。
- POST /v1/datasets/pro_services/unlocks 解锁所选 apex,返回详细信息。
- 需要时用 GET /v1/me/credits 查询余额。
REST 调用需 Authorization: Bearer vk_… 头,无匿名层级。API 密钥在 https://servicegraph.co/profile/api-keys 创建,放入 .env.local 的 SERVICEGRAPH_API_KEY(不要将密钥读入模型上下文或粘贴到聊天中)。任何 HTTP 客户端均可,示例用 curl。
过滤 DSL 类似 GitHub 搜索语法:AND 优先于 OR(需用括号);逗号列表表示同一谓词内的 OR;否定用 -x 或 NOT x;裸词为关键词搜索(多词短语需加引号)。示例:industry:engineering_services service_provided:civil-engineering state:FL transportation;industry:engineering_services service_provided:structural-engineering (high-rise OR commercial);industry:engineering_services service_provided:civil-engineering@high has:clutch。
适用场景
- 按州和交通关键词查找土木工程公司,并希望工程师持有 PE 执照。
- 为商业高层建筑寻找结构工程公司。
- 为医院项目寻找 MEP 工程公司。
- 为工业设施寻找机械/HVAC 工程公司。
- 在加州寻找岩土工程公司。
- 用户提供 8–20 个工程公司域名进行补全:逐个 GET /v1/datasets/pro_services/:apex 获取免费简要(404 表示不在目录中,不收费),用户选定后再批量解锁。
限制与注意事项
- 不适用于软件/SaaS/应用开发需求、内部"工程经理"招聘、系统/云/数据库架构问题、建筑设计公司(由 find-architecture-firm 负责)、消费者/住宅需求(仅 B2B)、非美国公司、个人自由工程师、DIY 问题,以及工程软件产品对比(Revit、AutoCAD、SolidWorks、Ansys 等)。
- 工程类公司评价稀少,rating>=N 会大幅缩小可用的筛选结果;建议用 @high 证据 + 公司规模 + 地理位置作为质量替代指标,或使用更宽松的 has:clutch。
- 叠加过窄关键词(如 seismic)会使候选池急剧缩小;删掉这类收窄关键词后,可用的候选公司会明显更多。
- 简要卡片包含 apex、名称、位置和评分信号;不包含 url、phone_primary、email_primary、legal_name、address_full 和完整 platforms 映射,这些需解锁(每家公司10积分,30天有效,期间重复查看免费)。
- 解锁是原子操作:N 个 apex 要么全部计费(最多 10×N 积分),要么在 402 时全部不计费。404(not_found / not_in_dataset)跳过且不收费。
- 错误以 JSON 信封 {"error": {"code": "…", "message": "…"}} 返回。400 包括 filter_parse_error(附位置)、kind_in_filter(需去掉 kind:)、field_not_in_dataset、invalid_apex;401 需重新获取密钥;402 为积分不足(needed 与 balance,未扣费);429 需遵守 Retry-After。