mcpField
P
people-property

people-property

github.com/merit-systems生产力337 次安装34 周前更新
代码仓库

关于 people-property

此 Skill 通过 x402 保护的 Whitepages 接口按姓名和地点搜索人物,或按地址查询房产及所有者信息。适用于需要核验联系信息或研究美国房产的场景,并要求遵循隐私规则。

主要功能

  1. 01按姓名和地点搜索人物
  2. 02查询房产及所有者信息
  3. 03返回地址、电话和关联人员
  4. 04提供接口发现与查询流程
  5. 05标明费用及数据限制

适用场景

  1. 01核验人物的联系信息
  2. 02查找人物当前及过往地址
  3. 03研究房产类型与详情
  4. 04在正当用途下重新联系他人

MCP 相关

此 Skill 使用 x402 MCP 工具发现接口并调用 Whitepages 搜索端点;每次查询收费。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/merit-systems/x402scan-skills --skill people-property

安装后在 Claude Code 中输入/people-property确认已加载。

附带文件rules/getting-started.mdrules/privacy.md

详细介绍

使用 Whitepages 搜索人员和房产

停止 — 调用任何 API 前请先阅读。 enrichx402.com 端点与各提供商的原生 API 并不相同。所有路径均采用 https://enrichx402.com/api/{provider}/{action} 格式。你必须执行以下任一操作:

  1. 从下方的快速参考表中复制准确的 URL,或
  2. 运行 x402.discover_api_endpoints(url="https://enrichx402.com") 获取正确路径

猜测路径会失败,并返回 405 错误(路径错误)或 404 错误(缺少 /api/ 前缀)。

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

设置

请参阅 rules/getting-started.md 了解安装和钱包设置。

重要: 此技能可访问个人信息。使用前请查看 rules/privacy.md。

快速参考

任务端点价格描述
搜索人员https://enrichx402.com/api/whitepages/person-search$0.44按姓名/地点查找人员
搜索房产https://enrichx402.com/api/whitepages/property-search$0.44房产和业主信息

搜索人员

按姓名和地点搜索人员:

x402.fetch(
  url="https://enrichx402.com/api/whitepages/person-search",
  method="POST",
  body={
    "firstName": "John",
    "lastName": "Smith",
    "city": "Seattle",
    "state": "WA"
  }
)

参数:

  • firstName - 名
  • lastName - 姓(必填)
  • city - 城市名称
  • state - 州缩写(美国)
  • zip - 邮政编码
  • address - 街道地址

返回内容:

  • 全名和年龄范围
  • 当前和曾用地址
  • 电话号码
  • 关联人员(亲属、联系人)
更精确的搜索

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

x402.fetch(
  url=".../whitepages/person-search",
  body={
    "firstName": "John",
    "lastName": "Smith",
    "address": "123 Main St",
    "city": "Seattle",
    "state": "WA",
    "zip": "98101"
  }
)

搜索房产

搜索房产信息:

x402.fetch(
  url="https://enrichx402.com/api/whitepages/property-search",
  method="POST",
  body={
    "address": "123 Main Street",
    "city": "Seattle",
    "state": "WA"
  }
)

参数:

  • address - 街道地址(必填)
  • city - 城市名称
  • state - 州缩写
  • zip - 邮政编码

返回内容:

  • 房产地址(标准化)
  • 业主姓名
  • 房产类型(独栋住宅、公寓等)
  • 房产详情

响应数据

人员搜索字段
  • name - 法定全名
  • ageRange - 估计年龄范围
  • currentAddress - 当前住所
  • historicalAddresses - 过去的地址
  • phoneNumbers - 关联电话号码
  • associatedPeople - 亲属和联系人
房产搜索字段
  • address - 标准化地址
  • owner - 房产业主姓名
  • propertyType - 房产类型
  • yearBuilt - 建成年份(如有)
  • bedrooms / bathrooms - 房产详情
  • squareFootage - 面积(如有)

工作流

验证联系信息
  1. 确认用途正当(请参阅 rules/privacy.md) 2.(可选)检查余额:x402.get_wallet_info
  2. 发现端点(首次获取数据前必须执行): x402.discover_api_endpoints(url="https://enrichx402.com")
  3. 使用可用的详细信息进行搜索,并使用发现结果或上方快速参考表中的准确 URL
  4. 验证结果是否与预期人员相符
x402.fetch(
  url="https://enrichx402.com/api/whitepages/person-search",
  method="POST",
  body={"firstName": "Jane", "lastName": "Doe", "city": "Portland", "state": "OR"}
)
房产调查
  • [ ](可选)检查余额:x402.get_wallet_info
  • 按地址搜索
  • 查看业主和房产详情
x402.fetch(
  url="https://enrichx402.com/api/whitepages/property-search",
  method="POST",
  body={"address": "456 Oak Avenue", "city": "Austin", "state": "TX"}
)
与某人重新建立联系
  • 确认用途正当
  • 尽可能提供详细信息以提高准确性
  • 检查结果,确认匹配正确
x402.fetch(
  url="https://enrichx402.com/api/whitepages/person-search",
  method="POST",
  body={"firstName": "Michael", "lastName": "Johnson", "state": "CA"}
)

成本注意事项

每次调用的费用为 $0.44,Whitepages 是 x402 套件中最昂贵的端点。

场景费用
单次查询$0.44
验证地址和人员$0.88
多个候选对象$1.32 及以上

降低成本的提示:

  • 尽可能提供更多信息,以便首次查询就获得准确结果
  • 优先使用免费来源(LinkedIn、公司网站)
  • 使用 apollo、clado、firecrawl、WebSearch、WebFetch 获取有助于提高查询准确性的数据
  • 仅用于必要的查询

局限性

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

评论

支持 Markdown