Altmetric MCP

🚀 Altmetric MCP Server

このModel Context Protocol (MCP)サーバーは、AIエージェントがAltmetric APIにアクセスできるようにし、ニュース媒体、政策文書、ソーシャルメディアなどのオンラインプラットフォームを通じて、研究成果の注目度と到達範囲を追跡することができます。

Altmetricは、従来の学術的引用を超えて、研究が議論されている場所を監視します。主流メディアの報道から政策文書の引用、特許の参照、ソーシャルメディアでの関与まで、現実世界における研究の影響を包括的に把握することができます。

🚀 クイックスタート

📦 インストール

前提条件

• Node.js >= 18.0.0
• Altmetric APIの認証情報:
  • Details Page API: 無料プランまたは商用アクセス - APIアクセスをリクエスト
  • Explorer API: 機関アクセス - APIアクセスをリクエスト

注意: 少なくとも1つのAPI設定（Details PageまたはExplorer）が必要です。

始めるには

npxを使用してAltmetric MCPサーバーを実行するように、MCPクライアントを設定します（クライアント自身のドキュメントを参照）。

{
  "command": "npx",
  "args": ["-y", "altmetric-mcp"],
  "env": {
    "ALTMETRIC_DETAILS_API_KEY": "your_details_api_key_here",
    "ALTMETRIC_EXPLORER_API_KEY": "your_explorer_api_key_here",
    "ALTMETRIC_EXPLORER_API_SECRET": "your_explorer_api_secret_here"
  }
}

ヒント:

• アクセス権のあるAPIの認証情報のみを含めてください。

以下は、人気のAIツールやエディターの具体的な設定手順です。

{
  "servers": {
    "altmetric-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "altmetric-mcp"],
      "env": {
        "ALTMETRIC_DETAILS_API_KEY": "your_details_api_key_here",
        "ALTMETRIC_EXPLORER_API_KEY": "your_explorer_api_key_here",
        "ALTMETRIC_EXPLORER_API_SECRET": "your_explorer_api_secret_here"
      }
    }
  }
}

{
  "ALTMETRIC_DETAILS_API_KEY": "your_details_api_key_here",
  "ALTMETRIC_EXPLORER_API_KEY": "your_explorer_api_key_here",
  "ALTMETRIC_EXPLORER_API_SECRET": "your_explorer_api_secret_here"
}

claude mcp add --transport stdio altmetric-mcp --env ALTMETRIC_DETAILS_API_KEY=your_details_api_key_here --env ALTMETRIC_EXPLORER_API_KEY=your_explorer_api_key_here --env ALTMETRIC_EXPLORER_API_SECRET=your_explorer_api_secret_here -- npx -y altmetric-mcp

{
  "mcpServers": {
    "altmetric-mcp": {
      "command": "npx",
      "args": ["-y", "altmetric-mcp"],
      "env": {
        "ALTMETRIC_DETAILS_API_KEY": "your_details_api_key_here",
        "ALTMETRIC_EXPLORER_API_KEY": "your_explorer_api_key_here",
        "ALTMETRIC_EXPLORER_API_SECRET": "your_explorer_api_secret_here"
      }
    }
  }
}

{
  "mcpServers": {
    "altmetric": {
      "command": "npx",
      "args": ["-y", "altmetric-mcp"],
      "env": {
        "ALTMETRIC_DETAILS_API_KEY": "your_details_api_key_here",
        "ALTMETRIC_EXPLORER_API_KEY": "your_explorer_api_key_here",
        "ALTMETRIC_EXPLORER_API_SECRET": "your_explorer_api_secret_here"
      }
    }
  }
}

✨ 主な機能

このMCPサーバーは、2つのAPIを通じてAltmetricデータにアクセスするための9つのツールを提供します。

Details Page APIツール

1. get_citation_counts (無料プラン)

DOI、PubMed ID、arXiv IDなどの識別子を使用して、研究成果のさまざまなプラットフォームでの注目度メトリクスと言及数を取得します。

パラメーター:

• identifier (必須): 研究成果の識別子（例: "10.1038/nature12373"）
• identifier_type (任意): 識別子のタイプ - "doi", "pmid", "arxiv", "id", "ads", "urn", "uri", または "isbn" (デフォルト: "doi")

例:

{
  "identifier": "10.1038/nature12373",
  "identifier_type": "doi"
}

2. get_citation_details (商用プラン)

研究がオンラインで議論されている方法に関する詳細な言及情報を取得します。投稿の全文、著者詳細、完全なメタデータが含まれます。

パラメーター:

• identifier (必須): 研究成果の識別子
• identifier_type (任意): "doi" または "id" (デフォルト: "doi")
• citation_type (任意): タイプでフィルタリング - "twitter", "news", "blog", "policy", "patent" など
• page (任意): ページネーションのページ番号 (デフォルト: 1)

例:

{
  "identifier": "10.1038/nature12373",
  "identifier_type": "doi",
  "citation_type": "news"
}

3. search_citations (無料プラン)

特定の期間内に追跡されたすべての研究成果の集計された注目度データを検索します。

パラメーター:

• timeframe (必須): "1d", "2d", "3d", "4d", "5d", "6d", "1w", "1m", "3m", "6m", "1y", または "at" (全期間)
• citation_type (任意): 引用元のタイプでフィルタリング
• nlmid (任意): ジャーナルのNLM IDでフィルタリング
• issns (任意): ジャーナルのISSNでフィルタリング（カンマ区切り）
• subject (任意): Scopusの学科分野でフィルタリング
• num_results (任意): 返す結果の数
• page (任意): ページネーションのページ番号

例:

{
  "timeframe": "1w",
  "citation_type": "news",
  "num_results": 50
}

Explorer APIツール (機関用)

4. explore_research_outputs

機関のAltmetric Explorerインスタンス内で研究成果を検索およびフィルタリングします。著者、部署、ジャーナル、出版日、研究タイプなどでのフィルタリングをサポートします。

主要パラメーター:

• q: タイトル、著者、またはジャーナルの検索クエリ
• scope: "all" または "institution"
• type: 研究成果のタイプでフィルタリング（例: ["article", "dataset"]）
• timeframe: 注目度の期間でフィルタリング
• page_number, page_size: ページネーションの制御

5. explore_attention_summary

クエリに一致する研究成果の集計された注目度メトリクスを取得し、ソース（ニュース、Twitter、政策文書など）と日付別に分解します。

主要パラメーター:

• q: 検索クエリ
• timeframe: 注目度の期間
• type: 研究成果のタイプでフィルタリング

6. explore_mentions

研究成果の個々の言及を取得し、各言及に関する詳細情報（著者、URL、タイムスタンプ、プラットフォームなど）を含みます。

主要パラメーター:

• q: 検索クエリ
• mentioned_after/mentioned_before: 日付範囲のフィルタリング
• countries: 国コードでフィルタリング
• page_number, page_size: ページネーションの制御

7. explore_demographics

研究成果に関与する聴衆の人口統計情報を取得します。地理的分布、人口統計パターン、聴衆の特性を分析します。

主要パラメーター:

• q: 検索クエリ
• scope: "all" または "institution"
• timeframe: 注目度の期間
• type, journal_id, author_id: 研究属性でフィルタリング

8. explore_mention_sources

研究成果の言及元に関する情報を取得します。どのプラットフォーム、チャネル、アウトレットが研究を言及しているかを、ソースの信頼性と到達範囲のデータで分析します。

主要パラメーター:

• q: 検索クエリ
• mentioned_after/mentioned_before: 日付範囲のフィルタリング
• source_type: ソースのタイプでフィルタリング（ニュース、Twitter、政策など）
• countries: 国コードでフィルタリング
• page_number, page_size: ページネーションの制御

9. explore_journals

ジャーナル関連のデータとメトリクスを取得します。出版場所で検索およびフィルタリングし、ジャーナルの影響力を分析し、ジャーナルのランキングを取得します。

主要パラメーター:

• q: ジャーナル名またはISSNの検索クエリ
• journal_id, issn: ジャーナルの識別子でフィルタリング
• subject: 学科分野でフィルタリング
• publisher: 出版社名でフィルタリング
• page_number, page_size: ページネーションの制御

📚 ドキュメント

• Details Page API: https://details-page-api-docs.altmetric.com/
• Explorer API: https://explorer-api-docs.altmetric.com/

📄 ライセンス

MIT