people-property

使用 Whitepages 搜索人员和房产

通过受 x402 保护的端点访问人员和房产搜索。

设置

有关安装和钱包设置，请参阅 rules/getting-started.md。

重要： 此技能可访问个人信息。使用前请阅读 rules/privacy.md。

快速参考

任务	端点	价格	描述
人员搜索	https://stableenrich.dev/api/whitepages/person-search	$0.22	按姓名/地点查找人员
房产搜索	https://stableenrich.dev/api/whitepages/property-search	$0.22	房产和所有者信息

人员搜索

按姓名和地点搜索人员：

npx agentcash@latest fetch https://stableenrich.dev/api/whitepages/person-search -m POST -b '{
  "first_name": "John",
  "last_name": "Smith",
  "city": "Seattle",
  "state_code": "WA"
}'

重要：州参数名为 state_code，而不是 state。请使用两个字母的州缩写（例如，“CA”、“NY”、“TX”）。

参数：

• first_name - 名字
• last_name - 姓氏
• name - 全名（替代名字/姓氏）
• phone - 电话号码
• city - 城市名称
• state_code - 两个字母的州缩写（美国）
• zipcode - ZIP 代码（不是 zip）
• street - 街道地址
• min_age / max_age - 年龄筛选条件
• radius - 地址周围的半径，单位为英里（最大 100）

返回内容：

• 全名、别名和出生日期
• 当前和历史地址
• 电话号码和电子邮件地址
• 亲属、拥有的房产、职位/公司

更具体的搜索

提供更多详细信息，以获得更准确的匹配结果：

npx agentcash@latest fetch https://stableenrich.dev/api/whitepages/person-search -m POST -b '{
  "first_name": "John",
  "last_name": "Smith",
  "street": "123 Main St",
  "city": "Seattle",
  "state_code": "WA",
  "zipcode": "98101"
}'

房产搜索

搜索房产信息：

npx agentcash@latest fetch https://stableenrich.dev/api/whitepages/property-search -m POST -b '{
  "street": "123 Main Street",
  "city": "Seattle",
  "state_code": "WA"
}'

重要：州参数名为 state_code，而不是 state。请使用两个字母的州缩写（例如，“CA”、“NY”、“TX”）。

参数：

• street - 街道地址（必填；别名：address、street_line、street_address）
• city - 城市名称
• state_code - 两个字母的州缩写（不是 state）
• zipcode - ZIP 代码（不是 zip 或 postal_code）

返回内容：

• 房产地址（标准化）
• 所有者和居民（含电话/电子邮件地址）
• 房产详情、市场价值、销售历史、税务信息

注意：如果该地址没有索引记录，端点会返回 200 并附带 { "result": null }，而不是 404。

响应数据

人员搜索字段

响应格式为 { "persons": [...] }。每位人员包含：

• name / aliases - 全名和已知别名
• date_of_birth - 出生日期（如有）
• current_addresses / historic_addresses - 当前和过往地址
• phones - 电话号码及其类型和评分
• emails - 关联的电子邮件地址
• relatives - 相关人员
• owned_properties - 拥有的房产
• linkedin_url / company_name / job_title - 职业信息（如有）

房产搜索字段

响应格式为 { "result": {...} }（无记录时为 { "result": null }）：

• property_address / mailing_address - 标准化地址
• ownership_info - owner_type、person_owners、business_owners
• residents - 当前居民及其电话/电子邮件地址
• property_details - year_built、bedrooms、bathrooms、building_area、lot_size、property_use 等
• market_value - 估算价值和范围
• sale_history - 过往销售记录，含日期、价格、买方/卖方
• tax_info - 评估价值和税额

工作流

验证联系信息

• 确认用途合法（参见 rules/privacy.md）
• （可选）检查余额：npx agentcash@latest balance
• 使用已有的详细信息进行搜索
• 确认结果与预期人员匹配

npx agentcash@latest fetch https://stableenrich.dev/api/whitepages/person-search -m POST -b '{"first_name": "Jane", "last_name": "Doe", "city": "Portland", "state_code": "OR"}'

房产调查

• （可选）检查余额：npx agentcash@latest balance
• 按地址搜索
• 查看所有者和房产详情

npx agentcash@latest fetch https://stableenrich.dev/api/whitepages/property-search -m POST -b '{"street": "456 Oak Avenue", "city": "Austin", "state_code": "TX"}'

与某人重新联系

• 确认用途合法
• 尽可能提供详细信息，以提高准确性
• 查看结果，确认匹配对象正确

npx agentcash@latest fetch https://stableenrich.dev/api/whitepages/person-search -m POST -b '{"first_name": "Michael", "last_name": "Johnson", "state_code": "CA"}'

成本考量

Whitepages 每次调用收费 $0.22，是 x402 套件中价格较高的端点之一。

场景	费用
单次查询	$0.22
验证地址 + 人员	$0.44
多个候选结果	$0.66+

降低成本的建议：

• 尽可能提供更多信息，以提高首次查询的准确性
• 优先使用免费来源（LinkedIn、公司网站）
• 使用 clado、minerva、firecrawl、WebSearch、WebFetch 获取数据，让查询更准确
• 仅用于必要的查询

限制

• 数据主要面向美国
• 结果取决于公共记录的可用性
• 部分个人的信息可能有限
• 最近搬家的人可能会显示旧地址
• 不包括未公开或私人电话号码