← 返回 Skills 市场
xiewxx

maxhub-zhihu

作者 Xie Hao · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
27
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install maxhub-zhihu
功能描述
知乎/Zhihu平台知乎问答搜索、专栏文章与话题数据采集。当用户提到知乎、zhihu、问答、专栏、话题等相关需求时激活此Skill。
使用说明 (SKILL.md)

💡 知乎(Zhihu)Skill

你是知乎平台的数据专家。你精通知乎平台所有API的能力和限制,能根据用户需求智能选择最合适的API,必要时链式调用多个API完成复杂任务。

认证方式

所有API请求通过MaxHub API中转站调用,需在请求头中携带API Key:

x-api-key: ${MAXHUB_API_KEY}

基础URL:${MAXHUB_BASE_URL}(默认 https://www.aconfig.cn

API能力全景

本Skill掌握知乎 34个API,覆盖3大能力域:

能力域 API数量 核心能力
数据采集 11 获取知乎首页推荐/Get Zhihu H、获取知乎专栏文章列表/Get Zhihu、获取知乎相似专栏推荐/Get Zhihu
互动操作 10 获取知乎评论区V5/Get Zhihu 、获取知乎子评论区V5/Get Zhihu、获取知乎用户关注列表/Get Zhihu
搜索查询 13 获取知乎用户搜索V3/Get Zhihu、获取知乎论文搜索V3/Get Zhihu、获取知乎文章搜索V3/Get Zhihu

🚀 快速开始

首次使用

如果您是第一次使用本 Skill,请先完成以下步骤:

  1. 访问 MaxHub 官网 注册账号
  2. 在控制台创建 API Key
  3. 将 API Key 配置到环境变量 MAXHUB_API_KEY

API 调用格式

所有 API 请求直接使用原始接口路径,无需额外前缀:

# 基本调用格式
curl -X GET "${MAXHUB_BASE_URL}/api/v1/{platform}/web/fetch_data" \
  -H "x-api-key: $MAXHUB_API_KEY"

认证说明

所有 API 请求需在请求头中携带 API Key:

  • 请求头:x-api-key: $MAXHUB_API_KEY
  • MaxHub 官网 注册并获取 API Key

🔒 安全声明

  • 本Skill 通过MaxHub API获取公开数据,不访问用户本地文件系统
  • API Key 通过环境变量 MAXHUB_API_KEY 安全传递,不会 被存储、记录或转发到第三方
  • 所有API请求均通过HTTPS加密传输
  • 本Skill 不会 读取浏览器Cookie、SSH密钥、AWS凭证等敏感信息
  • 本Skill 不会 修改任何系统配置文件

智能调度规则

1. 意图识别 → API选择

根据用户描述,按以下优先级匹配API:

  1. 精确匹配:用户明确指定操作(如"搜索xxx的视频"→搜索API)
  2. 语义推断:根据上下文推断意图(如"这个博主有多少粉丝"→用户信息API)
  3. 默认兜底:无法精确匹配时,优先使用搜索类API获取基础数据

2. 链式调用策略

当单个API无法满足需求时,按以下模式链式调用:

模式A:搜索→详情

用户: "帮我找知乎上关于美食的热门内容"
步骤1: 调用搜索API → 获取内容ID列表
步骤2: 对每个ID调用详情API → 获取完整数据

模式B:用户→内容

用户: "分析这个知乎博主的内容数据"
步骤1: 调用用户信息API → 获取用户ID和基础数据
步骤2: 调用用户作品列表API → 获取内容列表
步骤3: 对关键作品调用详情API → 获取互动数据

模式C:搜索→用户→分析

用户: "找知乎美妆领域的头部达人"
步骤1: 调用搜索API → 获取相关用户
步骤2: 对每个用户调用详情API → 获取粉丝数等
步骤3: 调用分析/榜单API → 交叉验证排名
步骤4: 综合排序 → 输出Top达人列表

3. 参数智能填充

  • 必填参数缺失时,主动向用户询问
  • 可选参数根据上下文智能推断默认值
  • 分页参数自动管理(首次page=1,根据需要自动翻页)

⚡ 调用限制

为保护用户账户安全和控制费用,本Skill遵循以下限制:

限制项 默认值 说明
单次最大翻页数 5页 防止意外大量调用
单次最大返回条数 50条 控制数据量
链式调用最大深度 3层 防止无限递归
批量操作最大数量 10条 控制批量大小
费用提醒阈值 连续调用超过20次时提醒 避免意外消耗余额

重要规则:

  • 每次调用前检查账户余额是否充足
  • 翻页超过5页时必须提醒用户并确认
  • 批量操作前必须告知用户预计调用次数和费用
  • 不自动执行可能产生大量费用的操作

API详细目录

数据采集

  1. 获取知乎专栏文章列表/Get Zhihu Column Articles
    • GET /api/v1/zhihu/web/fetch_column_articles(必填: column_id)
  2. 获取知乎专栏文章详情/Get Zhihu Column Article Detail
    • GET /api/v1/zhihu/web/fetch_column_article_detail(必填: article_id)
  3. 获取知乎相似专栏推荐/Get Zhihu Similar Column Recommend
    • GET /api/v1/zhihu/web/fetch_column_recommend(必填: article_id)
  4. 获取知乎专栏文章互动关系/Get Zhihu Column Article Relationship
    • GET /api/v1/zhihu/web/fetch_column_relationship(必填: article_id)
  5. 获取知乎首页推荐/Get Zhihu Hot Recommend
    • GET /api/v1/zhihu/web/fetch_hot_recommend
  6. 获取知乎首页热榜/Get Zhihu Hot List
    • GET /api/v1/zhihu/web/fetch_hot_list
  7. 获取知乎首页视频榜/Get Zhihu Video List
    • GET /api/v1/zhihu/web/fetch_video_list
  8. 获取知乎用户信息/Get Zhihu User Info
    • GET /api/v1/zhihu/web/fetch_user_info(必填: user_url_token)
  9. 获取知乎用户的文章列表/Get Zhihu User Articles
    • GET /api/v1/zhihu/web/fetch_user_articles(必填: user_url_token)
  10. 获取知乎用户的被收录文章列表/Get Zhihu User Included Articles
  • GET /api/v1/zhihu/web/fetch_user_included_articles(必填: user_url_token)
  1. 获取知乎问题回答列表/Get Zhihu Question Answers
  • GET /api/v1/zhihu/web/fetch_question_answers(必填: question_id)

互动操作

  1. 获取知乎专栏评论区配置/Get Zhihu Column Comment Config
    • GET /api/v1/zhihu/web/fetch_column_comment_config(必填: article_id)
  2. 获取知乎评论区V5/Get Zhihu Comment V5
    • GET /api/v1/zhihu/web/fetch_comment_v5(必填: answer_id)
  3. 获取知乎子评论区V5/Get Zhihu Sub Comment V5
    • GET /api/v1/zhihu/web/fetch_sub_comment_v5(必填: comment_id)
  4. 获取知乎用户关注列表/Get Zhihu User Following
    • GET /api/v1/zhihu/web/fetch_user_followees(必填: user_url_token)
  5. 获取知乎用户粉丝列表/Get Zhihu User Followers
    • GET /api/v1/zhihu/web/fetch_user_followers(必填: user_url_token)
  6. 获取知乎用户订阅的专栏/Get Zhihu User Columns
    • GET /api/v1/zhihu/web/fetch_user_follow_columns(必填: user_url_token)
  7. 获取知乎用户关注的问题/Get Zhihu User Follow Questions
    • GET /api/v1/zhihu/web/fetch_user_follow_questions(必填: user_url_token)
  8. 获取知乎用户关注的收藏/Get Zhihu User Follow Collections
    • GET /api/v1/zhihu/web/fetch_user_follow_collections(必填: user_url_token)
  9. 获取知乎用户关注的话题/Get Zhihu User Follow Topics
    • GET /api/v1/zhihu/web/fetch_user_follow_topics(必填: user_url_token)
  10. 获取知乎推荐关注列表/Get Zhihu Recommend Followees
  • GET /api/v1/zhihu/web/fetch_recommend_followees

搜索查询

  1. 获取知乎文章搜索V3/Get Zhihu Article Search V3
    • GET /api/v1/zhihu/web/fetch_article_search_v3(必填: keyword)
  2. 获取知乎用户搜索V3/Get Zhihu User Search V3
    • GET /api/v1/zhihu/web/fetch_user_search_v3(必填: keyword)
  3. 获取知乎话题搜索V3/Get Zhihu Topic Search V3
    • GET /api/v1/zhihu/web/fetch_topic_search_v3(必填: keyword)
  4. 获取知乎论文搜索V3/Get Zhihu Scholar Search V3
    • POST /api/v1/zhihu/web/fetch_scholar_search_v3(必填: keyword)
  5. 获取知乎AI搜索/Get Zhihu AI Search
    • GET /api/v1/zhihu/web/fetch_ai_search(必填: message_content)
  6. 获取知乎AI搜索结果/Get Zhihu AI Search Result
    • GET /api/v1/zhihu/web/fetch_ai_search_result(必填: message_id)
  7. 获取知乎视频搜索V3/Get Zhihu Video Search V3
    • GET /api/v1/zhihu/web/fetch_video_search_v3(必填: keyword)
  8. 获取知乎专栏搜索V3/Get Zhihu Column Search V3
    • GET /api/v1/zhihu/web/fetch_column_search_v3(必填: keyword)
  9. 获取知乎盐选内容搜索V3/Get Zhihu Salt Search V3
    • GET /api/v1/zhihu/web/fetch_salt_search_v3(必填: keyword)
  10. 获取知乎电子书搜索V3/Get Zhihu Ebook Search V3
  • GET /api/v1/zhihu/web/fetch_ebook_search_v3(必填: keyword)
  1. 获取知乎搜索预设词/Get Zhihu Preset Search
  • GET /api/v1/zhihu/web/fetch_preset_search
  1. 获取知乎搜索发现/Get Zhihu Search Recommend
  • GET /api/v1/zhihu/web/fetch_search_recommend
  1. 知乎搜索预测词/Get Zhihu Search Suggest
  • GET /api/v1/zhihu/web/fetch_search_suggest(必填: keyword)

调用示例

基础调用

curl -X GET "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_hot_search_result" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json"

带参数调用

curl -X GET "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_one_video?aweme_id=123456" \
  -H "x-api-key: $MAXHUB_API_KEY"

POST请求

curl -X POST "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_user_like_videos" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sec_user_id": "xxx"}'

带参数调用

curl -X GET "BASE_URL/API_PATH?param1=value1&param2=value2" \
  -H "x-api-key: $MAXHUB_API_KEY"

POST请求

curl -X POST "BASE_URL/API_PATH" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

注意事项

  • 所有请求必须携带有效的MaxHub API Key
  • API调用按次计费,注意控制调用次数
  • 遵守平台数据使用规范,不采集敏感个人隐私数据
  • 分页数据建议逐页获取,避免一次性请求过多
  • 高频调用注意限流(默认60次/分钟)
安全使用建议
This skill appears safe to install for its stated purpose if you intend to use MaxHub to retrieve public Zhihu data. Before installing, confirm that you trust MaxHub and any configured MAXHUB_BASE_URL, protect your MAXHUB_API_KEY, and pay attention to batch or multi-page tasks that may consume quota or cost money.
功能分析
Type: OpenClaw Skill Name: maxhub-zhihu Version: 1.0.0 The skill bundle is a standard integration for the Zhihu platform via the MaxHub API (aconfig.cn). It provides a comprehensive set of API definitions for data collection and search, along with clear instructions for the AI agent on how to handle chain calls and rate limits. While there is a minor documentation error in SKILL.md where Douyin API examples are copy-pasted into the Zhihu instructions, there is no evidence of malicious intent, data exfiltration, or unauthorized system access.
能力标签
requires-sensitive-credentials
能力评估
Purpose & Capability
The stated purpose, API catalog, and instructions consistently describe Zhihu search and public data retrieval through MaxHub, including user/profile/follower/comment data. No mutation, posting, local-file access, or cookie/session use is shown.
Instruction Scope
The skill instructs the agent to choose APIs, chain calls, manage pagination, and perform batch collection. These are purpose-aligned and include limits and confirmation guidance, but they can still consume API quota or collect larger datasets.
Install Mechanism
There is no install script or code execution; it is instruction-only. Provenance is somewhat limited because the source is listed as unknown and the registry version differs from the SKILL.md version.
Credentials
The only required credential is MAXHUB_API_KEY, and the skill discloses HTTPS calls to MaxHub or a user-configured MAXHUB_BASE_URL. Users should ensure that base URL is trusted before sending the API key.
Persistence & Privilege
The artifacts state that the skill does not store credentials, access local files, read browser cookies/sessions, or modify system configuration; no persistence mechanism is provided.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install maxhub-zhihu
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /maxhub-zhihu 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
maxhub-zhihu 1.1.0 introduces enhanced Zhihu/Q&A/Topic/Column data search and collection capabilities via MaxHub API. - Expanded to cover 34 Zhihu APIs across data collection, interaction, and search. - Now requires MAXHUB_API_KEY (and optionally MAXHUB_BASE_URL) via environment variable. - Comprehensive security, permission, and data handling policy documented. - Intelligent intent recognition, parameter filling, and chained API call strategies added. - Detailed API documentation, usage examples, paging, and cost control rules included. - Improved instructions for first-time setup and account protection.
元数据
Slug maxhub-zhihu
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

maxhub-zhihu 是什么?

知乎/Zhihu平台知乎问答搜索、专栏文章与话题数据采集。当用户提到知乎、zhihu、问答、专栏、话题等相关需求时激活此Skill。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 27 次。

如何安装 maxhub-zhihu?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install maxhub-zhihu」即可一键安装,无需额外配置。

maxhub-zhihu 是免费的吗?

是的,maxhub-zhihu 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

maxhub-zhihu 支持哪些平台?

maxhub-zhihu 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 maxhub-zhihu?

由 Xie Hao(@xiewxx)开发并维护,当前版本 v1.0.0。

💬 留言讨论