DK
Social API

DK Social API Docs

公开 API 文档

本页公开可读,供智能体和开发者理解 DK 工具的 REST API、MCP 接入、API Key、分页、调用日志和积分扣减方式。

当前公开启用工具共 30 个,覆盖 XHS、DY、SPH、KS 和 DOWNLOAD。接口新增、开放、关闭、参数、返回字段、扣费、分页或错误码变化后必须同步更新本文档。

API Key
登录用户端后创建或重置 API Key。完整 Key 只显示一次,请妥善保存。
REST API
统一使用 POST /api/tools/{toolName},请求体为 UTF-8 JSON。
MCP
支持智能体通过 /mcp 读取工具清单并调用工具。
调用日志
用户端保留调用日志,便于查看状态、耗时、traceId 和积分扣减。
REST 调用示例
curl -X POST "https://api.dk-ai.tech/api/tools/dy_search_videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json; charset=utf-8" \
  --data-binary '{"keyword":"\u5496\u5561","limit":20}'
params 包装格式
{
  "params": {
    "keyword": "咖啡",
    "limit": 20
  }
}
MCP 配置示例
{
  "mcpServers": {
    "dk-social": {
      "url": "https://api.dk-ai.tech/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
统一分页返回格式
{
  "items": [],
  "resultCount": 20,
  "pagination": {
    "hasMore": true,
    "nextCursor": "20",
    "cursorParam": "cursor",
    "searchId": "202607...",
    "requiredNextParams": ["cursor", "search_id"],
    "pageSize": 20
  },
  "nextCursor": "20"
}
抓 5 页并落盘
# 抓 5 页
for page in range(1, 6):
    payload = {"keyword": "咖啡", "limit": 20}
    if cursor:
        payload["cursor"] = cursor
    if search_id:
        payload["search_id"] = search_id
    data = call_dk_tool("dy_search_videos", payload)
    append_items_to_csv(data["items"])
    cursor = data.get("pagination", {}).get("nextCursor")
    search_id = data.get("pagination", {}).get("searchId") or search_id
    if not cursor or not data.get("pagination", {}).get("hasMore"):
        break
20/50 页任务规则
20 页任务:拆成 4 批,每批 5 页;每页写 CSV/JSONL;每批写 checkpoint。
50 页任务:拆成 10 批,每批 5 页;智能体只读取阶段汇总和最终文件,不要把原始 JSON 全部塞进上下文。
checkpoint 字段:toolName, page, cursor, nextCursor, searchId, traceId, creditsUsed, resultCount。
DK Skill 复制模板
# DK Skill

请先读取并学习 DK 工具文档:https://dk-ai.tech/docs

先不要向用户索要 API Key。请先完成:
1. 理解 REST API、MCP、工具目录、积分消耗和调用日志。
2. 简单任务优先用 MCP 读取工具清单并少量调用。
3. 复杂任务使用 REST API 分批获取,每页落盘到 CSV/JSONL 后再分析。
4. 中文关键词必须使用 UTF-8 JSON;不稳定终端可使用 Unicode escape。
5. 第一页不传 cursor;下一页读取 pagination.nextCursor;XHS 搜索可用 page=2/3/4 继续翻页。
6. 抓 20 页拆 4 批,抓 50 页拆 10 批,每批 5 页并写 checkpoint。
7. 每次记录 toolName、page、cursor、nextCursor、searchId、traceId、creditsUsed、resultCount。
8. NO_RESULTS 停止或换关键词;RATE_LIMITED 等待后重试;UPSTREAM_ERROR 记录 traceId 稍后重试;INSUFFICIENT_CREDITS 提示充值。

学会配置后,先告诉用户你已理解接入方式、推荐调用策略和所需参数。用户确认后,再让用户单独提供 DK_API_KEY。

当前已开放工具

工具名平台用途主要参数积分
xhs_search_notesXHS关键词搜索内容列表,返回标题、作者、封面、互动数据和可打开链接。keyword, limit, page20/页
xhs_get_note_detailXHS根据链接或内容 ID 查询详情,返回标题、正文、媒体、作者和互动数据。note_url 或 url15/次
xhs_extract_note_tokenXHS根据分享文本或链接做留存预检测,提取内容 ID 和访问 token。share_text, note_url 或 url3/次
xhs_get_author_profileXHS查询作者公开主页资料,返回昵称、头像、简介和公开统计信息。author_id15/次
xhs_get_author_notesXHS查询作者主页公开内容列表,返回作品、封面、标题、互动数据和下一页游标。author_id, cursor, limit20/页
xhs_get_note_commentsXHS查询公开评论列表,返回评论内容、时间、点赞数和分页信息。note_id, limit, lastCursor, pages20/页
xhs_get_primary_commentsXHS获取一级公开评论,返回评论内容、时间、点赞数和分页信息。note_id, limit, lastCursor, pages20/页
xhs_get_primary_secondary_commentsXHS获取一级公开评论和二级公开评论,返回层级关系、评论内容和分页信息。note_id, limit, lastCursor, pages, subCommentPages20/页
dy_search_videosDY关键词搜索内容列表,返回标题/描述、作者、封面、互动数据和下一页游标。keyword, limit, cursor, search_id20/页
dy_get_hot_search_listDY查询热搜榜单,返回榜单词、热度和趋势信息。20/页
dy_get_hot_video_listDY查询热门内容榜单,返回热门内容、作者和互动数据。20/页
dy_get_video_detailDY根据视频 ID 查询内容详情,返回标题/描述、作者、封面、互动数据和可打开链接。video_id10/次
dy_get_video_by_share_urlDY根据分享链接解析内容详情,返回标题/描述、作者、封面、互动数据和可打开链接。share_url10/次
dy_get_author_profileDY查询作者公开主页资料,返回昵称、头像、简介和公开统计信息。author_id10/次
dy_get_author_videosDY查询作者主页公开视频列表,返回作品、封面、描述、互动数据和下一页游标。author_id, limit, cursor20/页
dy_get_video_commentsDY查询公开评论列表,返回评论内容、时间、点赞数和分页信息。video_id, limit, cursor20/页
sph_search_defaultSPH关键词搜索默认排序内容列表,返回标题、作者、封面和互动数据。keyword, session_buffer20/页
sph_search_latestSPH关键词搜索最新排序内容列表,返回标题、作者、封面和互动数据。keyword, session_buffer20/页
sph_search_ordinarySPH关键词搜索综合排序内容列表,返回标题、作者、封面和互动数据。keyword, session_buffer20/页
sph_get_video_detailSPH根据内容 ID 查询详情,返回标题、作者、封面、互动数据和可打开链接。video_id, export_id10/次
sph_get_video_by_share_urlSPH根据分享链接解析内容详情,返回标题、作者、封面、互动数据和可打开链接。share_url10/次
sph_get_commentsSPH查询公开评论列表,返回评论内容、时间、点赞数和分页信息。video_id, lastBuffer, comment_id20/页
sph_get_author_homepageSPH查询主页公开内容,返回主页作品列表、作者资料和下一页游标。author_id, lastBuffer20/页
ks_search_videosKS关键词搜索视频内容,返回标题/描述、作者、封面、互动数据和下一页游标。keyword, pcursor20/页
ks_search_comprehensiveKS关键词综合搜索内容,返回标题/描述、作者、封面、互动数据和下一页游标。keyword, pcursor20/页
ks_get_video_detailKS根据内容 ID 查询详情,返回标题/描述、作者、封面、互动数据和可打开链接。photo_id 或 video_id10/次
ks_get_video_by_urlKS根据分享链接解析内容详情,返回标题/描述、作者、封面、互动数据和可打开链接。share_url10/次
ks_get_video_commentsKS查询公开评论列表,返回评论内容、时间、点赞数和分页信息。photo_id 或 video_id, pcursor20/页
ks_get_author_videosKS查询作者主页公开视频列表,返回作品、封面、描述、互动数据和下一页游标。author_id, pcursor20/页
video_download_parseDOWNLOAD根据公开视频链接解析标题、封面和可用媒体地址。url20/次

标准返回字段

DK 会在不改变原始字段的基础上补充这些标准字段,方便前端和智能体消费。字段只有在源数据返回时才会出现;不会用 0 或空字符串假造缺失字段。普通公开工具不返回敏感账号标识。

账号字段
avatarbioverifiedverifyInfofollowersCountfollowingCountlikedCountcollectedCountpostCountlocation
作品字段
coverUrltitlecontentpublishTimelikeCountcollectCountcommentCountshareCountviewCountimageUrlstagsstickycommercial
评论字段
userNameuserAvatarcommentTextlikeCountreplyCountcommentTimeipLocationisAuthorReplyisSticky

能力目录

公开能力范围
具体可用范围以账号权限和管理员开通状态为准。

XHS

8 个公开工具

  • 内容搜索
  • 内容详情
  • 留存预检测
  • 作者资料
  • 作者作品
  • 公开评论

DY

8 个公开工具

  • 内容搜索
  • 热榜/趋势
  • 内容详情
  • 分享链接解析
  • 作者资料
  • 作者作品
  • 公开评论

SPH

7 个公开工具

  • 默认搜索
  • 最新搜索
  • 综合搜索
  • 内容详情
  • 分享链接解析
  • 作者主页
  • 公开评论

KS

6 个公开工具

  • 视频搜索
  • 综合搜索
  • 内容详情
  • 分享链接解析
  • 作者作品
  • 公开评论

DOWNLOAD

1 个公开工具

  • 公开视频链接解析
公开 JSON
智能体可以直接读取这些链接。
DK 工具目录 JSONDK 积分说明 JSON

用户端按积分结算。单项按次扣减,搜索、列表、评论、作者作品和榜单类通常按页扣减;具体数值以管理员配置为准。