Profile Researcher

🚀 LinkedInプロフィールデータマイニングMCPサーバー

このサーバーは、LinkedInプロフィールのデータマイニング、検索、および連絡先情報の充実化に特化した包括的なモデルコンテキストプロトコル（MCP）サーバーです。元のデータマイニングツールのすべての強力な機能をMCP互換インターフェースに統合しています。

✨ 主な機能

🔍 高度な検索機能

• Google検索統合：Google Custom Search APIを使用してLinkedInプロフィールを発見します。
• AIによるクエリ拡張：OpenAI GPT - 4o miniを使用して追加の検索クエリを生成します。
• スマートフィルタリング：AIベースの関連性フィルタリングにより、高品質の検索結果を保証します。
• 地域ベースの検索：グローバルな地域ターゲティングをサポートし、網羅的な検索を可能にします。

📊 プロフィールデータ抽出

• 直接のLinkedInスクレイピング：LinkedInページから直接プロフィールデータを抽出します。
• Nubela Proxycurlフォールバック：直接のスクレイピングが失敗した場合、Nubela APIを使用します。
• 構造化データ解析：LinkedInプロフィールからJSON - LD構造化データを抽出します。
• 包括的なプロフィールフィールド：名前、会社、職名、説明、フォロワー数など。

📞 連絡先情報の充実化

• Apollo.io統合：プロフィールに電子メールアドレスと電話番号を追加します。
• 会社情報：詳細な会社説明と連絡先情報を取得します。
• 専門的な検証：API検証により連絡先情報の正確性を保証します。

🤖 AIベースの機能

• プロフィール要約：AIを使用して簡潔なプロフィール要約を生成します。
• 関連性スコアリング：AIベースのフィルタリングにより、検索意図に合致する結果を提供します。
• クエリ最適化：インテリジェントな検索クエリの生成と拡張を行います。
• 複数のLLMサポート：OpenAI、Gemini、OpenRouter、およびOllamaと互換性があります。

💾 データ管理

• SQLiteデータベース：抽出されたすべてのプロフィールを永続的に保存します。
• CSVエクスポート：分析やCRM統合のために簡単にデータをエクスポートできます。
• 重複防止：自動的に重複するプロフィールを検出し、防止します。
• データ検証：データの品質と完全性を保証します。

📦 インストール

1. サーバーディレクトリにクローンまたは移動します。

   cd smithery-servers/profile-searcher
   

2. 依存関係をインストールします。

   npm install
   

3. APIキーを設定します。

   # サンプル設定ファイルをコピーします
   cp .env.example .env
   
   # .envをAPIキーで編集します
   nano .env  # または好みのエディタを使用してください
   

4. 開発サーバーを起動します。

   npm run dev
   

🔑 APIキーの設定

📋 詳細な設定手順については、CONFIGURATION.mdを参照してください。

クイックセットアップ:

1. 必須：Apollo.io APIキー → apollo.io/settings/integrationsから取得します。
2. 必須：OpenAI APIキー → platform.openai.com/api-keysから取得します。
3. オプション：Nubela APIキー → nubela.co/proxycurlから取得します。

環境変数（.envファイル）:

APOLLO_API_KEY=your_apollo_api_key_here
OPENAI_API_KEY=sk-your_openai_api_key_here
NUBELA_API_KEY=your_nubela_api_key_here
DEBUG=false

Claude Desktop用（claude_desktop_config.json）:

{
  "mcpServers": {
    "profile-searcher": {
      "command": "node",
      "args": ["/path/to/smithery-servers/profile-searcher/dist/index.js"],
      "env": {
        "APOLLO_API_KEY": "your_apollo_api_key_here",
        "OPENAI_API_KEY": "sk-your_openai_api_key_here"
      }
    }
  }
}

利用可能なツール

1. search_linkedin_profiles

キーワードに基づいてLinkedInプロフィールを検索します。

パラメーター:

• keywords (文字列): 検索キーワード（例: "AIポッドキャストホスト"）
• num_results (数値): 返す結果の数（デフォルト: 20）

例:

{
  "keywords": "AI podcast host",
  "num_results": 10
}

2. extract_profile_data

LinkedInのURLから詳細なプロフィールデータを抽出します。

パラメーター:

• urls (配列): LinkedInプロフィールURLの配列
• include_contact_info (ブール値): 連絡先情報を含めるかどうか（デフォルト: true）

例:

{
  "urls": [
    "https://www.linkedin.com/in/example-profile",
    "https://www.linkedin.com/in/another-profile"
  ],
  "include_contact_info": true
}

3. mine_linkedin_data

包括的なデータマイニング：検索、抽出、およびプロフィールデータの充実化を行います。

パラメーター:

• keywords (文字列): 検索するキーワード
• num_results (数値): 処理するプロフィールの数（デフォルト: 20）
• export_csv (ブール値): CSVにエクスポートするかどうか（デフォルト: true）
• csv_filename (文字列、オプション): カスタムCSVファイル名

例:

{
  "keywords": "blockchain developer",
  "num_results": 25,
  "export_csv": true,
  "csv_filename": "blockchain_developers.csv"
}

4. get_contact_info

Apollo APIを使用して特定の人物の連絡先情報を取得します。

パラメーター:

• person_name (文字列): 人物のフルネーム
• company_name (文字列): 人物が勤務する会社

例:

{
  "person_name": "John Smith",
  "company_name": "Tech Corp"
}

5. export_to_csv

保存されているすべてのプロフィールデータをCSVファイルにエクスポートします。

パラメーター:

• filename (文字列、オプション): エクスポートするカスタムファイル名

例:

{
  "filename": "all_profiles_export.csv"
}

6. get_stored_profiles

データベースに保存されているすべてのプロフィールを取得します。

パラメーター: なし

7. generate_search_queries

AIを使用して追加の検索クエリを生成します。

パラメーター:

• main_query (文字列): 拡張するメインの検索クエリ
• num_queries (数値): 追加のクエリの数（デフォルト: 3）

例:

{
  "main_query": "site:linkedin.com/in AI podcast host",
  "num_queries": 5
}

📚 ドキュメント

データ構造

プロフィールデータフィールド

抽出された各プロフィールには、以下のフィールドが含まれています。

interface ProfileData {
  author_profile_url: string;           // LinkedInプロフィールURL
  author_name?: string;                 // フルネーム
  authors_desc?: string;                // プロフィールの見出し/説明
  Company?: string;                     // 現在の会社
  Job_title?: string;                   // 現在の職名
  InteractionStatistic_followers?: string; // フォロワー数
  email?: string;                       // 電子メールアドレス（Apolloから）
  phone1?: string;                      // 主要な電話番号（Apolloから）
  phone2?: string;                      // 2番目の電話番号（Apolloから）
  about_company?: string;               // 会社の説明（Apolloから）
  profile_summary?: string;             // AIによって生成された要約
  post_details?: string;                // 最近の投稿内容
  transcript?: string;                  // ポッドキャスト/ビデオの文字起こし
  post_summary?: string;                // 投稿のAI要約
  transcript_summary?: string;          // 文字起こしのAI要約
  author_activity?: string;             // 活動の要約
}

データベーススキーマ

サーバーはSQLiteを使用しており、3つの主要なテーブルがあります。

1. author_urls_table：完全なプロフィール情報を保存します。
2. validated_profiles：AI検証結果を追跡します。
3. search_queries：検索クエリと結果を保存します。

ファイル構造

smithery-servers/profile-searcher/
├── src/
│   └── index.ts              # メインサーバーの実装
├── package.json              # 依存関係とスクリプト
├── README.md                 # このドキュメント
├── smithery.yaml            # Smitheryの設定
├── Database/                # SQLiteデータベースファイル
│   └── author_profile_.db   # メインデータベース
└── Data/                    # CSVエクスポートファイル
    └── *.csv               # エクスポートされたプロフィールデータ

💻 使用例

基本的なプロフィール検索

// AIポッドキャストホストを検索する
const result = await mcpClient.callTool("search_linkedin_profiles", {
  keywords: "AI podcast host",
  num_results: 15
});

包括的なデータマイニング

// ブロックチェーン開発者のデータをマイニングする
const result = await mcpClient.callTool("mine_linkedin_data", {
  keywords: "blockchain developer",
  num_results: 30,
  export_csv: true,
  csv_filename: "blockchain_talent.csv"
});

連絡先情報の検索

// 特定の人物の連絡先情報を取得する
const result = await mcpClient.callTool("get_contact_info", {
  person_name: "Jane Doe",
  company_name: "AI Innovations Inc"
});

🔧 技術詳細

レート制限とベストプラクティス

1. レート制限を尊重する：サーバーにはリクエスト間の組み込み遅延が含まれています。
2. APIキーの管理：APIキーを安全に保管し、使用状況を監視してください。
3. データプライバシー：データ保護規制に準拠することを確認してください。
4. 倫理的な使用：ツールを責任を持って使用し、LinkedInの利用規約を尊重してください。

トラブルシューティング

一般的な問題

1. 依存関係が欠落している：npm installを実行して、すべてのパッケージがインストールされていることを確認してください。
2. APIキーエラー：すべての必須APIキーが正しく設定されていることを確認してください。
3. データベースのパーミッション：Databaseディレクトリに書き込み権限があることを確認してください。
4. ネットワーク問題：API呼び出しのためのインターネット接続を確認してください。

デバッグモード

詳細なログを表示するには、設定でデバッグモードを有効にします。

{
  "debug": true
}

コントリビュート

このサーバーは包括的なデータマイニングツールに基づいており、そのすべての高度な機能を含んでいます。改善やバグ報告については、元の実装を参照してください。

📄 ライセンス

ISCライセンス - 詳細についてはpackage.jsonを参照してください。

免責事項

このツールは、合法的なビジネスおよび研究目的にのみ使用されることを前提としています。ユーザーは、LinkedInの利用規約、データ保護規制、および適用される法律に準拠する責任を負います。常にプライバシーを尊重し、個人データを収集する前に必要な許可を取得してください。