people-search

Lessie — 人物検索と情報拡充

セットアップ

Lessie は 2 つのモードに対応しています。CLI（デフォルト、推奨）と MCP サーバーです。

モード A：CLI（デフォルト）

Lessie CLI バイナリをインストールします。

npm install -g @lessie/cli

または、インストールせずに使用します。

npx @lessie/cli --version

初回の認証：

lessie auth

ブラウザーが開き、ログインまたは登録できます。トークンは ~/.lessie/oauth.json にキャッシュされます。

接続を確認します。

lessie status

モード B：MCP サーバー

MCP 設定に追加します（Claude Code ~/.claude.json、Cursor ~/.cursor/mcp.json、Codex ~/.codex/config.toml など）。

{
  "mcpServers": {
    "lessie": {
      "command": "npx",
      "args": ["-y", "@lessie/mcp-server"],
      "env": {
        "LESSIE_REMOTE_MCP_URL": "https://app.lessie.ai/mcp-server/mcp"
      }
    }
  }
}

アンインストール

• CLI： npm uninstall -g @lessie/cli && rm -rf ~/.lessie/
• MCP： .json から "lessie" エントリーを削除し、rm -rf ~/.lessie/ を実行します。

バージョン確認

各セッションの開始時、モードを判定する前に、以下の確認を一度ずつ実行します。どちらも処理を妨げないため、コマンドが失敗した場合（ネットワークエラー、タイムアウトなど）は何も通知せずにスキップして続行します。

スキルのバージョン

1. このファイルの上部にあるメタデータの version フィールドから、現在のローカルバージョンを読み取ります。
2. リモートバージョンを取得します。

   curl -sf --max-time 5 https://raw.githubusercontent.com/LessieAI/lessie-skill/main/people-search/SKILL.md | head -5 | grep 'version:' | head -1 | awk '{print $2}'
   

3. リモートバージョンがローカルバージョンより新しい場合は、ユーザーに通知します。

   ⬆️ people-search スキルの新しいバージョンが利用可能です（{local} → {remote}）。次のコマンドを実行して更新してください。

   npx skills add LessieAI/lessie-skill -y -g
   

4. バージョンが一致する場合、または確認に失敗した場合は、何もせずスキップします。

CLI のバージョン

1. ローカル CLI のバージョンを取得します。

   lessie --version 2>/dev/null || npx @lessie/cli --version 2>/dev/null
   

2. 公開されている最新バージョンを取得します。

   npm view @lessie/cli version 2>/dev/null
   

3. リモートバージョンのほうが新しい場合は、ユーザーに通知します。

   ⬆️ Lessie CLI の新しいバージョンが利用可能です（{local} → {remote}）。次のコマンドを実行して更新してください。

   npm install -g @lessie/cli
   

4. バージョンが一致する場合、またはいずれかのコマンドが失敗した場合は、何もせずスキップします。

クイックスタート

セットアップ後、Claude に次のように話しかけてみてください。

• 「サンフランシスコにいる Stripe のエンジニアリングマネージャーを探して」
• 「Sam Altman の連絡先情報を調べて」
• 「OpenAI を調査して。最近のニュースと募集中の求人を知りたい」

モードの判定

各セッションの開始時に、使用するモードを判定します。

1. lessie CLI が利用可能か確認します。lessie status を実行してください。
2. コマンドが成功した場合は、CLI モードを使用します（Bash 経由でツールを呼び出します）。
3. コマンドが失敗した場合（見つからない場合）、自動インストールを試みます。npm install -g @lessie/cli
4. インストール後、lessie status を再度実行して確認します。
5. インストールに成功した場合は、CLI モードを使用します。
6. インストールに失敗した場合（npm がない、権限が拒否された、ネットワークエラーなど）、MCP ツール（authorize、use_lessie）が利用可能か確認します。
7. MCP ツールが利用可能な場合は、MCP モードを使用します。
8. どちらも利用できない場合は、インストールに失敗したことをユーザーに伝え、手動インストールまたは MCP のセットアップを提案します。

クレジットと料金

Lessie はクレジット制のサービスです。

新規アカウントには無料トライアル用のクレジットが付与されます。残高の確認やクレジットの購入は https://lessie.ai/pricing で行えます。

エージェントは検索前に企業名の曖昧さを解消し、誤った結果にクレジットが消費されないようにします。

データとプライバシー

• データソース： 連絡先情報と企業情報は、公開されている情報源（企業名簿、ソーシャルプロフィール、企業ウェブサイト）から集約されています。
• クエリのログ記録： 検索クエリは、サービスの改善と不正利用の防止を目的として記録されます。クエリデータが第三者と共有されることはありません。
• データコンプライアンス： Lessie は適用されるデータ保護規制に準拠しています。取得した連絡先データを現地の法律（GDPR、CAN-SPAM など）に準拠して使用する責任は、ユーザーにあります。
• プライバシーポリシー： https://lessie.ai/privacy
• 利用規約： https://lessie.ai/terms-of-service

認証

CLI モード

1. lessie status を実行して、トークンの有効性を確認します。
2. authorized: false の場合は、lessie auth を実行してログイン用のブラウザーを開きます。
3. ユーザーがログインを完了したら、lessie status を再度実行して確認します。

MCP モード

1. authorize を呼び出して、接続状態を確認します。
2. すでに認証済みの場合 → そのままツールを使用します。
3. 認証されていない場合 → authorize が認証 URL を返します。Lessie のログイン／登録のためにブラウザーを開く必要があることをユーザーに伝え、適切なシステムコマンドを使って開きます。
   • macOS: open "<url>"
   • Linux: xdg-open "<url>"
   • Windows: start "<url>"
4. ブラウザーを開いたことと、ログイン／登録を完了する必要があることをユーザーに伝えます。
5. ユーザーの確認後、接続を検証するために再度 authorize を呼び出します。
6. 認証に失敗した場合（タイムアウト、拒否、ポートの競合）は、authorize が返す診断のヒントに従って再試行します。

ブラウザーを開く前に、必ずユーザーに知らせてください。通知せずにリダイレクトしてはいけません。

エージェントの動作ルール

重要：クレジットを消費する操作の前に、毎回確認する

Lessie のツール呼び出しはすべてクレジットを消費します。ツールごとのクレジット消費量は次のとおりです。

ツール	消費量
find-people	検索ごとに20 クレジット
enrich-people	1 人あたり 1 クレジット（マッチに成功した場合のみ課金）
review-people	1 人あたり 1 クレジット
enrich-org	1 クレジット
find-orgs	1 クレジット
job-postings	1 クレジット
company-news	1 クレジット
web-search	1 クレジット
web-fetch	1 クレジット
unlock_emails	新たにロックを解除する人ごとに3 クレジット（現行料金。最新の料金は応答内の price_per_unlock を確認してください）。以前の検索でロックを解除済みの人は、すべて無料です。検索に失敗しても課金されません
unlock_email_by_handle	ロック解除に成功するごとに3 クレジット（現行料金。最新の料金は応答内の price_per_unlock を確認してください）。not_found と failed は無料です。冪等ではありません。同じハンドルで再実行すると、再度課金されます
unlock_phones	新たにロックを解除する人ごとに8 クレジット（現行料金。料金は応答内の price_per_unlock を確認してください）。以前の検索でロックを解除済みの人は無料です。non_unlockable ／ failed は課金されません。ユーザーごとの冪等性の仕様は unlock_emails と同じです
unlock_phone_by_handle	ロック解除に成功するごとに8 クレジット（現行料金）。platform="linkedin" のみ実際に解決されます。他のプラットフォームでは reason="unsupported_platform" を伴う not_found が返され、無料です。同じ (linkedin, handle) の組み合わせでは冪等ではありません

コマンドを実行する前に、必ず次のことを行ってください。

1. 実行する内容と見積もりコストをユーザーに伝えます（例：「3 人の情報を補完します。約 3 クレジットかかります」）。
2. 実行前に、ユーザーから明示的な確認を得るまで待ちます。
3. 実行計画全体への確認を得ずに、クレジットを消費する呼び出しを複数まとめて実行してはいけません。

**例外 — ユーザーが確認を求めないよう明示した場合（例：「毎回聞かないで」「そのまま実行して」「確認を省略して」）は、確認を省略できます。**その場合は、そのまま実行し、各呼び出しの後に実行内容と消費したクレジットを記録してください。

重要：呼び出しごとにクレジットの使用量を報告する

Lessie のツール呼び出しを 1 回以上行った会話ターンの後には、消費したクレジットの概要を 1 行で追記してください。形式：

\<tool-name> を使用、 クレジットを消費しました。

同じターン内で複数のツールを呼び出した場合は、まとめて記載します。

web-search + enrich-org を使用、合計 2 クレジットを消費しました。

重要：最初の CLI 呼び出しの前にリファレンスを読む

**セッション中に初めて lessie CLI コマンドを実行する前に、必ず references/cli-reference.md を読んで、正確なパラメーター構文を確認してください。**ツールごとにフラグのセットが異なります。find-people は --query（NL）、enrich-people は --people（JSON）、unlock-emails ／ unlock-phones は --search-id + --person-ids、unlock-email-by-handle ／ unlock-phone-by-handle は --handles を使用するなど、それぞれ異なります。推測せず、呼び出すツールのセクションを読んでください。

検索モードの判別（B2B と KOL）

Lessie は、データソースと結果の種類が異なる 2 つの検索モードに対応しています。

• B2B モード：専門データベース（LinkedIn ベース）を検索します。職種、企業、役職レベル、業界から人材を探すのに最適です。勤務先のメールアドレス、電話番号、職歴が返されます。
• KOL モード：ソーシャルメディアプラットフォーム（Instagram、YouTube、TikTok、Twitter/X）を検索します。オーディエンス、フォロワー数、コンテンツのトピックからインフルエンサー、コンテンツクリエイター、著名人を探すのに最適です。ソーシャルリンク、フォロワー数が返されます。

ユーザーの意図が曖昧な場合（つまり、LinkedIn 上の専門職とソーシャルメディア上のクリエイターのどちらも検索対象になり得る場合）は、検索前に必ずユーザーに確認してください。次のように、両方の選択肢を簡潔に提示します。

曖昧なクエリの例：「脳波をモニタリングする睡眠デバイスを実際に使った経験があり、その知見を共有できる人を探してください。」

次のどちらも考えられます。

1. B2B：睡眠テック企業のプロダクトマネージャー、エンジニア、研究者（LinkedIn 経由）
2. KOL：そのようなデバイスをレビューまたは使用したことのある、健康・テック系インフルエンサー（ソーシャルメディア経由）

次のように尋ねてください：「睡眠テック企業の PM やエンジニアなど、LinkedIn 上の専門職をお探しですか。それとも、睡眠デバイスをレビューするソーシャルメディアのクリエイターでしょうか。どちらをご希望ですか。それとも両方ですか？」

意図が明確な場合は、そのまま検索を進めてください。

• 「フィンテックのスタートアップ企業で CTO を探してください」→ B2B（明白）
• 「Instagram でフォロワーが 10 万人以上の美容インフルエンサーを探してください」→ KOL（明白）

エンティティの判別

ユーザーが複数のエンティティを指し得る企業名（例：「Manus」は Manus AI、Manus Bio、Manus Plus などを指す可能性があります）を挙げた場合は、検索前に対象を明確にしてください。

1. ユーザーに尋ねて、どの企業を指しているのか確認するか、候補の上位を提示して選んでもらいます。
2. 文脈から対象が明確な場合（例：ユーザーが以前に AI エージェントについて話していた場合）は、想定している対象を示して確認します：「AI エージェント企業の Manus AI（manus.im）のことでしょうか？」
3. あるエンティティを別のエンティティだと確認せずに決めつけないでください。ドメインを間違えると、検索クレジットを無駄にし、関連性のない結果が返されます。

ツールの概要

人物

ツール	CLI コマンド	使用する場面
find_people	lessie find-people	自然言語のタスクを使って人物を見つけます。ユーザーのリクエストをそのまま --query に渡します。エージェントがソース（B2B／KOL／ウェブ）、キーワードを選び、検索を自動的に停止します。上限：1 リクエストあたりツール呼び出し 3 回、予算 60 秒。 応答に partial: true が含まれている場合、エージェントは予算上限に達しています。結果はタイムアウト前に収集できたものです
enrich_people	lessie enrich-people	既知の人物のプロフィールを詳細化します。2 つの方法があります：B2B（linkedin_url または名前＋ドメイン経由 → メール、電話番号、職歴）と KOL（twitter／instagram／tiktok／youtube のユーザー名経由 → フォロワー数、ソーシャルリンク）。1 回の呼び出しで最大 10 件
review_people	lessie review-people	ウェブ調査で曖昧な候補者を詳しく評価します。明らかに一致する候補や一致しない候補は対象外です

連絡先のロック解除

ツール	CLI コマンド	使用する場面
unlock_emails	lessie unlock-emails	前回の find_people の結果に含まれる人物のメールアドレスをロック解除します。ユーザーごとに冪等です：すでにロック解除済みの人物（どの検索で解除した場合でも）は、費用がかかりません。search_id と person_ids（1～50件）を指定します
unlock_email_by_handle	lessie unlock-email-by-handle	事前の検索をせず、明示的に指定した (platform, handle) のメールアドレスをロック解除します。{platform, handle} のリスト（1～10件）を指定します。冪等ではありません。同じハンドルに対する呼び出しを繰り返すと、再度課金されます。実行した find_people の結果にそのハンドルが含まれていない場合にのみ使用してください
unlock_phones	lessie unlock-phones	前回の find_people の結果に含まれる人物の会社の電話番号をロック解除します。unlock_emails と同じユーザーごとの冪等性が適用されます。すでにロック解除済みの人物には費用がかかりません。search_id と person_ids（1～50件）を指定します
unlock_phone_by_handle	lessie unlock-phone-by-handle	事前の検索をせず、明示的に指定した (platform, handle) の電話番号をロック解除します。解決できるのは linkedin のみです。他のプラットフォームでは reason="unsupported_platform" を伴う not_found が返り、課金されません。冪等ではありません。{platform, handle} のリスト（1～10件）を指定します

判断ルール：

• メールと電話のどちらを選ぶか：ユーザーが実際に必要としている連絡手段を選んでください。unlock_emails と unlock_phones はそれぞれ独立しており、同じ人物に対して両方を呼び出すと、両方の料金が発生します。ユーザーがメールだけを希望している場合は、電話番号をロック解除しないでください
• 検索結果に基づくか、ハンドルに基づくか：人物が自分の find_people の結果に含まれている場合は、unlock_emails / unlock_phones を使用してください（再度ロック解除しても無料です）。ハンドルを lessie 以外から取得した場合（ユーザーが貼り付けた LinkedIn URLや、手動での言及など）は、unlock_email_by_handle / unlock_phone_by_handle を使用してください
• Tier 2 の電話番号に対応するのは LinkedIn のみ：Twitter / Instagram / TikTok / YouTube のハンドルを指定して unlock_phone_by_handle を実行すると、無料で reason="unsupported_platform" を伴う not_found が返ります。試して失敗したように見える前に、必ずユーザーに伝えてください

企業

ツール	CLI コマンド	使用する場面
find_organizations	lessie find-orgs	名前、キーワード、所在地、規模、資金調達状況から企業を探します
enrich_organization	lessie enrich-org	既知の企業ドメインの詳細なプロフィール（業界、従業員数、資金調達状況、技術スタック）を取得します
get_company_job_postings	lessie job-postings	現在募集中の求人を表示します（enrich で取得した organization_id が必要です）
search_company_news	lessie company-news	最近のニュース記事を探します（enrich で取得した organization_id が必要です）

ウェブ調査

ツール	CLI コマンド	使用する場面
web_search	lessie web-search	一般的なウェブ検索を行います。検索結果はキャッシュされるため、後続の web_fetch は無料です
web_fetch	lessie web-fetch	AI による要約を通じて、URL から特定の情報を抽出します

詳細リファレンス

• CLI コマンドの例と MCP の呼び出し：references/cli-reference.md を参照してください
• ワークフローのパターン（ドメインの解決、企業調査、検索と適格性評価）：references/workflow-patterns.md を参照してください
• ドメイン解決の判断ツリー：references/domain-resolution.md を参照してください

主な制約

• enrich_people / enrich_organization：1 回の呼び出しにつき最大 10 件です。これより多いリストはバッチに分割してください
• find_people：リクエストごとにツール呼び出し 3 回 + 実時間 60 秒が上限です。target_count は 1～100（デフォルトは 30）です。ページネーションには対応していません。さらに必要な場合は、異なるクエリで新たに呼び出してください
• find_organizations：ページネーションに対応しています。結果をさらに取得するには --page を使用してください
• web_search はページのコンテンツをキャッシュします。結果の has_content: true の場合、その URL への web_fetch の呼び出しは即座に完了します
• find-people クエリに含めると便利なキーワード：シニアリティを示す語句（owner、founder、c_suite、partner、vp、head、director、manager、senior、entry、intern）と、雇用の新しさを優先するための current または past。エージェントはこれらをフィルターとして直接使用します
• 人物のエンリッチメントでは、名前と併せて domain（会社のドメイン）を指定すると、照合精度が大幅に向上します
• CLI の出力は stdout に JSON、ステータスメッセージは stderr に出力されます。データの解析には stdout を使用してください