Altmetric MCP

🚀 Altmetric MCP 服務器

Altmetric MCP 服務器基於模型上下文協議（MCP），允許 AI 代理訪問 Altmetric API，以跟蹤研究成果在新聞媒體、政策文件、社交媒體及其他在線平臺上的關注度和影響力。

Altmetric 不僅關注傳統學術引用，還監測研究成果在主流媒體報道、政策引用、專利參考和社交媒體互動等方面的討論情況，提供研究在現實世界影響力的全面視角。

🚀 快速開始

本 MCP 服務器提供了通過兩個 API 訪問 Altmetric 數據的九種工具，能幫助你全面瞭解研究成果在不同平臺的關注度和影響力。

✨ 主要特性

• 多平臺監測：跟蹤研究成果在新聞媒體、政策文件、社交媒體等多個在線平臺的關注度和影響力。
• 全面視角：不僅關注傳統學術引用，還涵蓋主流媒體報道、政策引用、專利參考和社交媒體互動等方面。
• 多工具支持：提供九種工具，通過兩個 API 訪問 Altmetric 數據，滿足不同需求。

📦 安裝指南

前提條件

• Node.js >= 18.0.0
• Altmetric API 憑證：
  • 詳情頁面 API：免費套餐或商業訪問 - 申請 API 訪問
  • 探索者 API：機構訪問 - 申請 API 訪問

注意：至少需要一個 API 配置（詳情頁面或探索者）。

開始使用

配置你的 MCP 客戶端（查看其自身文檔），使用 npx 運行 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"
  }
}

提示：僅包含你有權訪問的 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"
      }
    }
  }
}

💻 使用示例

基礎用法

get_citation_counts（免費套餐）

使用 DOI、PubMed ID、arXiv ID 或其他標識符，檢索研究成果在各個平臺上的關注度指標和提及次數。

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

高級用法

get_citation_details（商業套餐）

檢索詳細的提及信息，包括帖子全文、作者詳情以及研究在網上討論情況的完整元數據。

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

📚 詳細文檔

API 層級

詳情頁面 API

• 免費套餐：可訪問 get_citation_counts 和 search_citations
• 商業套餐：可訪問所有詳情頁面工具，包括 get_citation_details

如果你使用免費 API 密鑰嘗試訪問 get_citation_details，將收到 403 錯誤。

探索者 API

• 僅機構訪問：所有探索者 API 工具都需要機構憑證。
• 可訪問整個 Altmetric 數據庫中的研究成果和關注度數據。
• 具有數據集成的組織還可以單獨訪問其機構的研究成果。
• 支持按作者、部門、期刊和自定義組織元數據進行高級篩選。

API 工具介紹

詳情頁面 API 工具

• get_citation_counts（免費套餐）：使用 DOI、PubMed ID、arXiv ID 或其他標識符，檢索研究成果在各個平臺上的關注度指標和提及次數。
• get_citation_details（商業套餐）：檢索詳細的提及信息，包括帖子全文、作者詳情以及研究在網上討論情況的完整元數據。
• search_citations（免費套餐）：在特定時間範圍內，搜索所有跟蹤的研究成果的彙總關注度數據。

探索者 API 工具（機構）

• explore_research_outputs：在你的機構 Altmetric 探索者實例中搜索和篩選研究成果。支持按作者、部門、期刊、出版日期、研究類型等進行篩選。
• explore_attention_summary：獲取與你的查詢匹配的研究成果的彙總關注度指標，按來源（新聞、Twitter、政策文件等）和日期細分。
• explore_mentions：檢索研究成果的個別提及信息，包括作者、URL、時間戳和平臺等詳細信息。
• explore_demographics：獲取參與研究成果的受眾的人口統計信息。分析地理分佈、人口統計模式和受眾特徵。
• explore_mention_sources：獲取研究成果提及來源的信息。分析哪些平臺、渠道和媒體正在提及研究，並提供來源可信度和影響力數據。
• explore_journals：獲取期刊相關數據和指標。按出版場所搜索和篩選，分析期刊影響力，並檢索期刊排名。

API 文檔

• 詳情頁面 API：https://details-page-api-docs.altmetric.com/
• 探索者 API：https://explorer-api-docs.altmetric.com/

📄 許可證

本項目採用 MIT 許可證。