Topyappers MCP

TopYappers MCP服务器

A. 模型上下文协议（MCP） 允许AI代理访问的服务器 TopYappers API公司 用于发现病毒式传播的内容、热门歌曲、有影响力的人和外展代理的电子邮件历史。

可用工具

入门指南

1. 获取TopYappers API密钥 topyappers.com/个人资料
2. 将MCP服务器添加到您的客户端（见下文）

设置

克劳德代码（CLI）

claude mcp add --transport http topyappers https://mcp.topyappers.com \
  --header "Authorization: Bearer YOUR_TOPYAPPERS_API_KEY"

或添加到 .mcp.json 在项目根目录中：

{
  "mcpServers": {
    "topyappers": {
      "type": "http",
      "url": "https://mcp.topyappers.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOPYAPPERS_API_KEY"
      }
    }
  }
}

光标

添加到MCP设置(.cursor/mcp.json):

{
  "mcpServers": {
    "topyappers": {
      "url": "https://mcp.topyappers.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOPYAPPERS_API_KEY"
      }
    }
  }
}

克劳德桌面版

增添 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%/Claude/claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "topyappers": {
      "url": "https://mcp.topyappers.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOPYAPPERS_API_KEY"
      }
    }
  }
}

认证

将您的TopYappers API密钥作为Bearer代币传递到 Authorization 头球服务器将其转发给TopYappers API-服务器上不存储密钥。

文档

每个API域的详细文档：

• 概述 --它是如何工作的，认证，学分
• 创作者和影响者 --搜索工作流程、参数、电源过滤器
• 代理外展 --项目、联系创作者、发送消息、回复
• 病毒式内容 --过滤器、病毒性评分、用例
• 视频 --搜索、排序、参与度过滤器
• 热门歌曲 --排名、新条目、历史、比较
• 参考 --所有枚举、国家、类别、语言

示例工作流

查找来自美国的病毒式健身内容

1. 呼叫 search_viral_content 随着 categories: ["Fitness"], countries: ["United States"], viralityScoreMin: 0.5
2. 获取带有参与度指标和创作者信息的病毒式视频

在Instagram上发现时尚影响者

1. 呼叫 search_creators 随着 source: "instagram", mainCategory: "Fashion", followersMin: 50000 （免费）
2. 呼叫 get_creator_profiles 与返回 userIds （各1学分）
3. 获取完整的个人资料，包括电子邮件、个人简介、参与率等。

查找英国流行歌曲

1. 呼叫 get_song_rankings 随着 country: "GB"
2. 获取包含歌曲标题、艺术家、排名和动态的最新图表
3. 呼叫 get_song_history 对特定歌曲进行更深入的分析

起草回复给通过电子邮件回复的创建者

1. 呼叫 list_contacted_creators 随着 creatorEmail: "creator@example.com"
2. 呼叫 list_agent_messages 与相同 creatorEmail 和 direction: "all"
3. 使用原始的推销、跟进、入站回复和项目详细信息来起草定制的回复

速率限制

• 每分钟60个请求 每个API密钥
• HTTP 429响应包括 retryAfter 指示等待秒数

链接

• TopYappers平台
• API文档
• 获取API密钥