mcpField
P
people-property

people-property

github.com/merit-systems生産性337 回インストール34 週間前に更新
リポジトリ

people-property について

x402で保護されたWhitepagesのエンドポイントを使い、名前と所在地から人物を検索したり、住所から不動産や所有者の情報を調べたりするスキルです。連絡先の確認や米国の不動産調査向けで、プライバシー規則とデータ上の制約を考慮します。

主な機能

  1. 01名前と所在地による人物検索
  2. 02不動産と所有者の検索
  3. 03住所、電話番号、関係者の取得
  4. 04エンドポイント発見と検索手順
  5. 05料金とデータ制約の明示

活用シーン

  1. 01連絡先情報の確認
  2. 02現住所と過去の住所の検索
  3. 03不動産の種類と詳細の調査
  4. 04正当な目的での知人との再連絡

MCP 対応

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 - 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 - ZIP コード

返される情報:

  • 不動産の住所(標準化済み)
  • 所有者名
  • 不動産の種類(一戸建て、コンドミニアムなど)
  • 不動産の詳細

レスポンスデータ

人物検索のフィールド
  • name - 法的な氏名
  • ageRange - 推定年齢層
  • currentAddress - 現住所
  • historicalAddresses - 過去の住所
  • phoneNumbers - 関連する電話番号
  • associatedPeople - 親族や知人
不動産検索のフィールド
  • address - 標準化された住所
  • owner - 不動産の所有者名
  • propertyType - 不動産の種類
  • yearBuilt - 建築年(利用可能な場合)
  • bedrooms / bathrooms - 不動産の詳細
  • squareFootage - 広さ(利用可能な場合)

ワークフロー

連絡先情報の確認
  1. 正当な目的であることを確認します(rules/privacy.md を参照)
  2. (任意)残高を確認します:x402.get_wallet_info
  3. エンドポイントを確認します(初回の取得前に必須): x402.discover_api_endpoints(url="https://enrichx402.com")
  4. 確認で得た URL または上記のクイックリファレンステーブルに記載された正確な URL を使用し、利用可能な詳細情報で検索します
  5. 検索結果が想定している人物と一致することを確認します
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"}
)

コストに関する注意点

1 回あたり $0.44 のため、Whitepages は x402 スイートで最も高価なエンドポイントです。

シナリオコスト
1 回の検索$0.44
住所と人物の確認$0.88
複数の候補者$1.32 以上

コストを抑えるためのヒント:

  • 初回の検索で正確な結果を得るため、できるだけ多くの情報を入力します
  • まず無料の情報源(LinkedIn、企業のウェブサイト)を利用します
  • apollo、clado、firecrawl、WebSearch、WebFetch を使用して、検索精度を高めるためのデータを取得します
  • 重要な検索にのみ使用します

制限事項

  • 米国に重点を置いたデータです
  • 結果は公開記録の利用状況によって異なります
  • 情報が限られている人物もいます
  • 最近引っ越した人物の古い住所が表示されることがあります
  • 電話帳に掲載されていない番号や非公開番号は含まれません

コメント