coolapk-mcp-pro
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| COOLAPK_NO_CACHE | No | 设为 1 禁用 GET 缓存(调试用) | |
| COOLAPK_LOGIN_MODE | No | 登录态来源:auto = 优先桌面端 accounts.json,回落本地配置;native = 仅用本地配置。取值以 auth 实现为准 | auto |
| COOLAPK_MAX_RETRIES | No | 瞬态错误(超时 / 5xx / 429)重试次数 | 2 |
| COOLAPK_MIN_INTERVAL | No | 相邻 API 请求最小间隔(秒) | 1.2 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
酷安社区只读工具集:搜索帖子/用户/话题/应用、查看帖子详情与评论、用户资料与动态、话题详情、首页动态、登录状态、图片下载、通用只读接口透传、作者画像与作者深挖聚合。全部工具只读,不会发帖、点赞或关注。搜索默认启用严格关键词过滤与去重(strict=False 可关闭);帖子详情在详情接口被风控时会自动回落到作者动态列表(fetch_source 字段标注来源);评论搜索(comment_keyword)最多翻 COOLAPK_MAX_REPLY_PAGES 页(默认 30),撞上限时 replies_truncated=True,可据 replies_next_page 继续。所有输出均经过白名单裁剪,只保留 agent 需要的核心字段;接口返回中的 cookie/token 等敏感字段一律剔除。帖子结果带 post_score(点赞+评论×3+转发×2)与 discussion_ratio,可直接用于排序筛选;判断教程可信度先看作者 author_tier(top/expert/active/normal),再决定是否用 coolapk_author_digest 深挖该作者的全部攻略。图片:若客户端显示不了 base64 图片(如手机语音助手、IM 机器人),用 coolapk_image_link 把图片 URL 转成签名 https 外链后再展示;本地 stdio 模式请直接用 coolapk_read_image。
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| coolapk_searchA | 搜索酷安社区内容(自动去重 + 严格关键词过滤 + 疑似广告标记)。 Args: keyword: 搜索关键词;多个词用空格分隔,strict 模式下要求全部命中 type: 搜索类型,可选 feed(帖子) user(用户) feedTopic(话题) app(应用) page: 页码 strict: 严格过滤(默认开):归一化后每个关键词都必须出现在标题/正文/作者名里, 可滤掉酷安搜索混入的不相关结果与机型名单广告;关闭则返回原始结果 sort: 帖子排序,hot(热门,默认)/reply(回复数)/default(综合)。 强烈建议保持默认 hot:酷安默认排序混入大量低互动点评, 实测 hot 直接返回高赞干货帖;结果带 like_num/reply_num 可再筛选 |
| coolapk_feed_detailA | 获取酷安帖子的完整详情和回复(详情接口被风控时自动回落)。 工具帖找资料建议用 comments_focus=smart:一次拿到「正文 + 楼主补充回复 + 高赞反馈」,获取方式与答疑多在楼主回复里(每个来源最多翻 5 页)。 Args: feed_id: 帖子 ID,也可直接粘贴酷安分享链接或整段分享文案 (如 https://www.coolapk.com/feed/1234567890),自动解析出 ID with_replies: 是否包含回复列表,默认是 reply_page: 回复页码(all_replies / comment_keyword / comments_focus 非 default 时忽略) all_replies: 拉全部一级评论(自动翻页,含内联楼中楼),适合完整舆情/评论分析 comment_keyword: 按关键词检索评论和楼中楼(最多翻 COOLAPK_MAX_REPLY_PAGES 页, 默认 30;空格分隔多词=任一命中;命中条目带 comment_match 字段, 楼中楼按上下文保留,统计见 comment_search;撞上限时 replies_truncated=True) comments_focus: 评论聚焦模式:default(默认时间序一页)/ smart(楼主回复 + 热门评论,各最多 5 页,找工具帖资料首选)/ author(只看楼主回复)/ hot(只看热门评论)/ all(全部一级评论,等同 all_replies)。 楼主回复与热门评论均按页收集(某页不足 10 条即末页,最多 5 页), 是否取全看返回的 focus_meta.truncated / pages_fetched / next_page / budget(两个来源合计的请求数与耗时) with_history: 附带正文修改历史(作者每次编辑的快照,看版本演进) expand_sub_replies: 深度展开楼中楼(对回复数多的父评论补全子回复, 楼主答疑常在楼中楼深处;会额外发请求,只在需要时开)。 有父评论没取全时返回 sub_replies_truncated=True focus_page: 焦点评论起始页(消费上一次的 focus_meta.next_page 用; 只在 comments_focus 为 smart/author/hot 时生效) |
| coolapk_user_profileC | 查看酷安用户资料。 Args: uid: 用户UID |
| coolapk_user_feedsA | 查看酷安用户发布的帖子(支持多页聚合、关键词过滤与热度排序)。 Args: uid: 用户UID page: 起始页码(pages>1 时从该页开始连续抓取) pages: 连续抓取页数 1-5,默认 1;想看某作者的历史干货时设 2-3 keyword: 只保留标题或正文含该词的帖子(空格分隔多词=任一命中) sort: 排序,default(接口原始顺序) / hot(互动热度) / latest(发布时间) keyword_mode: any(默认,任一命中) / all(全部命中,用于精确圈定同一主题) |
| coolapk_authorA | 查看酷安作者的画像与权威度评分(判断「这人是不是该领域大佬」)。 返回基础资料 + author_tier(top/expert/active/normal)、is_expert、 fans_per_feed(精发度)、expertise(从 bio 推断的专长领域)。 搜到高赞帖后先看作者 tier,再决定要不要用 coolapk_author_digest 深挖他的其他帖。 Args: uid: 用户UID |
| coolapk_author_digestA | 深挖某作者:一次调用拿到他在指定主题下的全部高赞帖(按热度排序)。 适合发现领域大佬(author_tier=top/expert)后,一次性抓出他关于该主题的 完整攻略链(例如「莫离然然」的解锁工具 v1.4→v2.2 全系教程)。 内部按 id 去重(置顶帖会跨页重复),关键词空格分隔多词=任一命中。 Args: uid: 作者UID keyword: 主题关键词(空格分隔多词=任一命中),留空返回全部帖子 pages: 抓取页数 1-5,默认 2(约 40 条) top: 返回条数上限,默认 10,最多 50 keyword_mode: any(默认,任一命中) / all(全部命中,避免「解锁」类泛词召回) |
| coolapk_homeA | 获取酷安首页动态(推荐 / 关注 / 热门 / 最新)。 返回 {"tab", "page", "fetched", "has_more", "next_page", "feeds"}:tab 回显 实际分栏(未知取值按 recommend 处理),feeds 为动态列表。 Args: tab: recommend(推荐,/v6/main/indexV8 算法推荐) follow(关注,只看已关注 的人) hot(热门) latest(最新) page: 页码,默认 1 |
| coolapk_boardA | 浏览酷安板块(数码、二手、摄影、汽车、好物等 21 个板块)。 板块动态与首页动态是两套入口:想看「数码区最近在聊什么」「二手区的行情」 用这个工具,不要用 coolapk_home。板块 ID 见 boards 映射,常用: digital(数码) phone(手机) computer(电脑) system(系统ROM) sheying(摄影) meihua(美化) car(汽车) waishe(外设) goods(好物) kaixiang(开箱) secondhand(二手) secondhand_apple(二手苹果) hot(热榜) news(快讯) video(视频) wenda(问答) topic(话题) headline(头条) xianliao(闲聊) coolpic(酷图) newphone(新机)。 Args: board: 板块 ID(如 digital)、中文名(如 手机/数码/二手交易)或 page_name(如 V10_DIGITAL_HOME) page: 页码,默认 1 |
| coolapk_secondhandA | 二手交易区动态(想了解某机型二手行情、看出售帖时用)。 Args: brand: 品牌 ID,0 表示全部;1005=苹果(其余品牌 ID 可先用 coolapk_search 搜到手机话题后按需试) page: 页码,默认 1 |
| coolapk_topicA | 查看酷安话题详情或话题下的帖子。 Args: tag: 话题标签名 with_feeds: 是否获取话题下的帖子列表 page: 帖子页码 hot_first: 话题帖子按热度排序(点赞+评论*3,默认开); 关闭则保持酷安默认顺序(时间流,多为最新低互动帖) |
| coolapk_app_detailA | 查看酷安应用详情(包名 → 应用名、简介、关注数、下载量、版本)。 搜到应用相关动态后,用包名查应用本身:判断「这是不是同一个 App」 「现在的最新版本号」比只看帖子标题可靠。 Args: package_name: 应用包名(如 com.coolapk.market) |
| coolapk_notifyA | 查看通知(@我的、评论、点赞、关注、私信)。 适合「有人回复我了吗」「私信里说了什么」这类需要个人时间线的场景; 只读,不会标记已读或回复。 Args: ntype: 通知类型,可选 atMeMeFeed(@我的动态) atComment(@我的评论) comment(评论) feedLike(点赞) contactsFollow(关注) message(私信), 默认 message page: 页码,默认 1 with_count: 是否附带各类型未读/总数统计(多一次请求) |
| coolapk_suggestA | 获取酷安搜索联想词(查询改写积木)。 输入自然语言或半成品关键词,返回酷安建议的规范搜索词, 可用于把口语化需求改写成酷安搜索习惯用词后再搜。 Args: keyword: 查询词(可以是口语化长句) |
| coolapk_login_statusA | 查看当前酷安登录状态(只读,不触发网络请求)。 返回 login_mode(登录模式配置)、is_logged_in(是否已登录)、 uid/username(登录用户)、source(登录态来源 desktop|native|none)、 device_code(设备码是否已配置)。 |
| coolapk_read_imageA | 下载酷安 CDN 图片并作为图片返回(支持一次多张,九宫格帖一次看全)。 仅允许酷安图片域名:image.coolapk.com / avatar.coolapk.com / static.coolapk.com。失败时返回结构化错误,可改用 coolapk_get_url 获取接口数据,或直接向用户呈现 URL。 Args: url: 一个或多个图片 URL,用逗号、空格或换行分隔,最多 9 张 (http 自动升级 https) |
| coolapk_image_linkA | 把酷安图片地址转成可直接在聊天窗口显示的 https 链接(需远程 HTTP 部署)。 为什么需要它:酷安 image.coolapk.com 对非酷安客户端返回 HTTP 567(防盗链), 很多聊天类客户端又没有解码 base64 的能力,只能显示文字链接。此工具把图片 转成托管在 MCP 服务上的签名链接(/img),链接自带过期时间与 HMAC 签名, 任何能打开网页的客户端都能直接显示图片。 仅在远程 HTTP 模式可用:MCP 进程需配置 COOLAPK_PUBLIC_BASE(对外访问前缀, 例如 https://mcp.example.com)与 COOLAPK_HTTP_TOKEN(用作签名密钥)。 Args: urls: 一个或多个酷安图片 URL,用逗号、空格或换行分隔 ttl_minutes: 链接有效期(分钟),默认 120,最长 10080(7 天) |
| coolapk_get_urlA | 只读透传:GET 任意酷安 /v6/ 只读接口路径并返回裁剪后的 JSON。 仅允许 api.coolapk.com 的 /v6/ 开头路径;含写动作的端点 (点赞/回复/关注/发帖/私信等)一律 403 拒绝。响应保留原始 结构(键名为酷安原始 camelCase),仅剔除 cookie/token 等敏感字段。 适合获取列表页未覆盖的数据(应用详情、板块、二级评论等)。 默认开启严格模式:额外要求末段形态像只读端点 (detail/list/info/space 等),未知写端点会被提前挡住; 设 COOLAPK_GET_URL_STRICT=0 可关闭(透传非常规只读路径时用)。 Args: path: 接口路径或完整 URL,如 /v6/apk/detail?id=com.tencent.mm |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
Most tools are distinct, but several pairs genuinely overlap: coolapk_author vs coolapk_user_profile (both return a user's profile, one adds tier scoring), coolapk_user_feeds with sort=hot/keyword vs coolapk_author_digest (near-identical outcomes), and coolapk_secondhand vs coolapk_board's secondhand/secondhand_apple boards. coolapk_get_url is also a catch-all that can duplicate nearly any read tool. The long descriptions do provide explicit guidance (e.g. 'don't use coolapk_home for boards'), which mitigates but does not remove the ambiguity.
All 17 tools share the coolapk_ prefix and snake_case, so the namespace is highly predictable. The only deviation is verb style: some are actions (coolapk_search, coolapk_suggest, coolapk_get_url, coolapk_read_image) while others are bare nouns (coolapk_author, coolapk_topic, coolapk_board, coolapk_notify), but each remains readable and unambiguous in form.
17 tools is slightly above the ideal band but each maps to a real Coolapk surface (feeds, comments, users, topics, boards, apps, notifications, images). The only borderline additions are coolapk_image_link/coolapk_read_image (two image tools) and the generic coolapk_get_url escape hatch, which could arguably be trimmed or folded in.
The read/analysis surface is unusually thorough: search + suggest, home/board/secondhand feeds, feed detail with rich comment modes, user feeds, author digest, app detail, notifications, image handling, and a raw /v6/ passthrough for anything uncovered. The notable gap is that the whole server is read-only — no posting, replying, liking or following — which is likely intentional but leaves the write half of the lifecycle uncovered.