pagerankcafe

pagerankcafe-mcp

面向 AI Agent 的营销平台。

一个用于 PageRankCafe API 的 MCP（Model Context Protocol）服务。它为 AI Agent 提供工具，用于在 PageRankCafe 上读取和发布链接广告、横幅广告、YouTube 视频广告以及新闻稿／博客文章，查看积分和推荐余额，读取各广告位的效果表现，并在付费套餐中获取整个平台的广告效果洞察。

获取密钥

1. 在 https://pagerankcafe.com 创建 PageRankCafe 账户。
2. 如果要使用写入和洞察工具，请在 https://pagerankcafe.com/membership-info 升级为付费会员（Bronze／Silver／Gold）。免费账户也可以使用读取工具。
3. 在 https://pagerankcafe.com/apiKeys 生成 API 密钥。

创建账户和生成密钥都需要在网站上手动完成，且由用户操作——不支持通过程序注册。

配置

服务从环境变量读取配置：

变量	必填	默认值	描述
PAGERANKCAFE_API_KEY	是	—	你在 /apiKeys 获取的 API 密钥。若未设置，服务会立即报错并退出。
PAGERANKCAFE_BASE_URL	否	https://pagerankcafe.com	API 基础 URL。仅在针对非生产环境进行测试时覆盖此项。

安装

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "pagerankcafe": {
      "command": "npx",
      "args": ["-y", "pagerankcafe-mcp"],
      "env": {
        "PAGERANKCAFE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add pagerankcafe --env PAGERANKCAFE_API_KEY=your-api-key-here -- npx -y pagerankcafe-mcp

Cursor

将以下内容添加到 Cursor MCP 设置中（~/.cursor/mcp.json 或项目的 .cursor/mcp.json）：

{
  "mcpServers": {
    "pagerankcafe": {
      "command": "npx",
      "args": ["-y", "pagerankcafe-mcp"],
      "env": {
        "PAGERANKCAFE_API_KEY": "your-api-key-here"
      }
    }
  }
}

工具

所有写入工具和洞察工具都要求付费会员资格（Bronze／Silver／Gold）；免费账户调用 API 时会收到错误。读取工具适用于任何有效密钥，包括免费账户的密钥。

工具	会员资格	描述
health	免费	检查 API 连通性，并返回已验证用户的用户名和会员状态。
list_links	免费	列出你的有效链接广告。
list_banners	免费	列出你的有效横幅广告。
list_youtube_ads	免费	列出你的有效 YouTube 视频广告。
list_press_releases	免费	列出你的有效新闻稿／博客文章。
get_credits	免费	返回你的积分余额、可用发布名额、已查看链接数和剩余链接数。
get_referral_stats	免费	返回你的推荐人数（今日、近 7 天、近 30 天、所有时间）。
list_posts	免费	返回链接、横幅、YouTube 或新闻稿广告各广告位的效果表现。
upload_image	付费	上传图片（本地文件路径或 base64），并返回托管的 HTTPS URL。
create_banner	付费	创建新的横幅广告。
post_banner	付费	使用积分将现有横幅广告加入轮播。
create_youtube_ad	付费	创建新的 YouTube 视频广告。
update_youtube_ad	付费	部分更新你拥有的现有 YouTube 广告。
create_press_release	付费	创建新的新闻稿／博客文章。
update_press_release	付费	部分更新你拥有的现有新闻稿。
post_press_release	付费	使用积分将现有新闻稿发布到主页小组件。
create_link	付费	创建新的链接广告。
post_link	付费	使用积分将现有链接广告加入轮播（仅限免费／积分发布：ad_days 必须为 0；view_time／view_credits 由服务端根据 icon／bold／double_time 推导，不接受作为输入）。如果发布立即生效，返回 status: "active"；如果发布用户需要先获得批准，则返回 status: "pending"（并附带说明性的 message）。
get_platform_insights	付费	按广告类型和选项汇总过去 30 天的平台效果表现，并提供当前价格。

每个底层端点的完整请求／响应详情见 OpenAPI 规范：https://pagerankcafe.com/api/spec（可在 https://pagerankcafe.com/api/docs 查看）。

错误处理

每个工具在成功时都会将 API 的 JSON 响应作为工具结果返回。对于非 2xx API 响应，工具会返回一个 MCP 工具错误（isError: true），其中包含 API 的错误消息。不会重试，也不会静默回退——调用失败时，工具调用一定会显示为失败。

开发

npm install
npm run build   # compiles src/ to dist/ with tsc
npm test        # builds, then runs the stdio smoke test (no network required)

该测试会通过标准输入/输出（stdio）将构建好的服务作为子进程启动（使用 @modelcontextprotocol/sdk 中的 StdioClientTransport），列出其工具，并检查完整的工具列表是否存在——无需真实的 API 密钥或网络访问。