# 有边界的平台原生操作

使用经过明确授权、单独定价的原生操作，每次调用都设定预算。

规范地址: https://socialtoai.com/zh/docs/raw/

## 查看允许的操作

为你的 Key 授予 Raw，MCP 加上 packs=raw。对所选平台调用 capabilities，从 raw_operations 中选择操作名。列表里没有的名字不能猜着用。这些操作读取受支持的公开数据。

## 为一次操作设定预算

用 platform、operation、params 和一个正数 max_cost（单位 credits）调用 raw，max_cost 不超过 1,000,000。未知参数、任意端点、凭据和不支持的身份都会被拒绝。HTTP GET 和 POST 都需要 Idempotency-Key；GET 以 JSON 编码 params。

输入限制为 8 KiB。每次被接受的调用发起一个固定的供应商请求。请在 OpenAPI 中查看该操作的精确输入 schema，并参考下方价格。成功和确认的空结果计费，失败不扣费。重放同一个逻辑请求不会产生新扣费或新的供应商请求。

```
{
  "platform": "bilibili",
  "operation": "video_parts",
  "params": {
    "video": "PASTE_PUBLIC_BV_ID"
  },
  "max_cost": 0.2
}
```

[精确输入 schema →](https://socialtoai.com/openapi.json)

## 读取原生字段与限制

成功响应返回一个 item，包含 platform_extra.raw 和 semantic_guarantee=native_fields_only。字段名、单位和相对时间保持源端含义。source_unknown 标记可选的空值，不代表 0。必需的业务数据缺失或为空时免费失败。

输出只选取文档记录的业务字段。每个叶子文本最多 2,000 个字符，truncated_fields 标记被截断的字段。结果必须小于 64 KiB，超大的列表和对象会明确失败。不提供媒体下载或私密内容操作。调用执行时限为 8 秒，微信相关操作为 25 秒。

## 一次翻一页

支持翻页的操作，把 page.cursor 放在 params.cursor 中，并保持原始业务参数不变。每一页都是单独计价的逻辑请求。cursor 经过加密，绑定工作区、平台、操作和参数，30 分钟后过期，最多 250 页。重复的页或不一致的源端 cursor 会免费失败；不会自动翻页。

## 原生操作价格

价格版本：standard-2026-09-08-12ebeeeacfa39f97。以下为网关调用价格。

| 平台 | 操作 | Credits | 可用性 |
|---|---|---|---|
| 小红书 | favorites | 1.5 | 可用 |
| 抖音 | video_stats | 0.2 | 可用 |
| 抖音 | related | 0.2 | 可用 |
| Reddit | highlights | 0.2 | 暂时不可用，调用不扣费 |
| Reddit | active_subs | 0.2 | 暂时不可用，调用不扣费 |
| Reddit | trophies | 0.2 | 可用 |
| 微信公众号 | article_stats | 1.5 | 可用 |
| 微信公众号 | related | 1.5 | 可用 |
| 微博 | reactions | 0.2 | 可用 |
| 微博 | reposts | 0.2 | 可用 |
| 哔哩哔哩 | video_parts | 0.2 | 可用 |
| 哔哩哔哩 | collections | 0.2 | 可用 |
| 哔哩哔哩 | dynamics | 0.2 | 可用 |
| 哔哩哔哩 | creator_stats | 0.2 | 暂时不可用，调用不扣费 |
| 知乎 | column_articles | 0.2 | 可用 |
| 知乎 | pins | 0.2 | 可用 |
| YouTube | community_posts | 0.2 | 可用 |
| YouTube | related | 0.2 | 可用 |