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 许可证。