Skip to main content
Glama
coolapk-mcp-pro

coolapk-mcp-pro

by yufeng-liang

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
COOLAPK_NO_CACHENo设为 1 禁用 GET 缓存(调试用)
COOLAPK_LOGIN_MODENo登录态来源:auto = 优先桌面端 accounts.json,回落本地配置;native = 仅用本地配置。取值以 auth 实现为准auto
COOLAPK_MAX_RETRIESNo瞬态错误(超时 / 5xx / 429)重试次数2
COOLAPK_MIN_INTERVALNo相邻 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.6/5.0

Scored across 17 tools

Disambiguation3/5

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.

Naming Consistency4/5

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.

Tool Count4/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessLimited data