给 AI Agent 接入中文社媒数据(MCP)

Qovia 是一个 MCP 服务:AI Agent 先搜索接口,再读参数,最后调用,不需要你为每个平台写一个工具。不用 MCP 的框架,也可以把同样的 HTTP 接口包成工具函数。

新账号有 50 次试用调用,之后按成功调用从预充值余额扣费,详见 定价。

一条命令接入 MCP

在 Claude Code 里运行下面这条命令。查找和查看接口不需要 Key;调用接口时按 MCP 文档 配置 API Key,Cursor、VS Code 和 Claude Desktop 的配置也在那里。

终端
claude mcp add --transport http qovia https://api.qovia.ai/mcp

服务提供四个工具:search_endpoints、get_endpoint、call_endpoint、get_account。AI 收到问题后自己找接口、读参数、调用,一次对话大致是这样:

一次对话中的工具调用
用户:「微博现在在热议什么?」
→ search_endpoints {"query": "weibo hot search"}
→ call_endpoint {"endpoint_id": "raw.weibo.hot_search", "params": {}}
← data.items(排名、词条、热度),meta.charged_usd

不用 MCP:把接口包成工具

下面是微博热搜接口的一次调用,放进任何框架的工具函数里即可。Key 放在环境变量 QOVIA_KEY。

  1. 一个接口就是一个工具

    GET /v1/raw/weibo/hot_search 不需要参数,返回微博实时热搜榜。其他接口的参数和返回见 API 参考;完整文档也有纯文本版(llms-full.txt)和 OpenAPI 3.1 规范,方便放进模型上下文或生成工具定义。

    微博热搜榜GET /v1/raw/weibo/hot_search

    cURL
    curl https://api.qovia.ai/v1/raw/weibo/hot_search \
      -H "Authorization: Bearer $QOVIA_KEY"
    Python
    import os
    import requests
    
    resp = requests.get(
        "https://api.qovia.ai/v1/raw/weibo/hot_search",
        headers={"Authorization": f"Bearer {os.environ['QOVIA_KEY']}"},
        timeout=30,
    )
    resp.raise_for_status()
    body = resp.json()
    print(body["meta"]["charged_usd"], body["data"])

    返回的 data 部分。示例取自接口目录,不是实时数据;列表只保留前两条,图片链接省略:

    200 OK
    {
      "data": {
        "items": [
          {
            "rank": 1,
            "word": "AG 退役",
            "heat": 1383391,
            "label": "新",
            "category": null,
            "is_topic": false,
            "url": "https://s.weibo.com/weibo?q=AG%20%E9%80%80%E5%BD%B9"
          },
          {
            "rank": 2,
            "word": "红果短剧自砍摇钱树",
            "heat": 1284794,
            "label": "热",
            "category": null,
            "is_topic": false,
            "url": "https://s.weibo.com/weibo?q=%E7%BA%A2%E6%9E%9C%E7%9F%AD%E5%89%A7%E8%87%AA%E7%A0%8D%E6%91%87%E9%92%B1%E6%A0%91"
          }
        ],
        "pinned": [
          {
            "rank": null,
            "word": "我们的长征路",
            "heat": null,
            "label": "热",
            "category": null,
            "is_topic": true,
            "url": "https://s.weibo.com/weibo?q=%23%E6%88%91%E4%BB%AC%E7%9A%84%E9%95%BF%E5%BE%81%E8%B7%AF%23"
          }
        ],
        "prov": {
          "hash": "0x91b7ec5e863c022e",
          "ts": "2026-10-21T23:50:00+08:00",
          "source": "live"
        }
      }
    }

更多相关接口

常见问题

怎么接到 Claude Code?

运行 claude mcp add --transport http qovia https://api.qovia.ai/mcp。查找和查看接口不需要 Key;调用接口时在 MCP 配置里加上 Authorization: Bearer 加你的 API Key。新账号有 50 次试用调用。

支持哪些客户端?

MCP 文档给出了 Claude Code、Cursor、VS Code 的配置,Claude Desktop 通过 mcp-remote 接入。其他支持 Streamable HTTP 的 MCP 客户端也可以连接 https://api.qovia.ai/mcp。

AI 能用哪些工具?

四个:search_endpoints 按关键词找接口,get_endpoint 看参数和示例,call_endpoint 执行接口,get_account 查余额和每分钟上限。

MCP 调用怎么计费?

和 HTTP API 完全一样:只对返回了数据的成功调用扣费,空结果和报错不扣费。新账号有 50 次试用调用,之后从预充值余额扣费,单价见 API 参考,套餐见定价页。

你的 Agent 能看到什么,取决于你给它什么数据

把抖音、小红书、公众号和电商评价交给它:结构化,按次计费,失败不扣费。