weread-skills

$npx mdskill add uvwt/agentdock/weread-skills

Search, manage bookshelf, notes, reviews, and reading stats on WeRead.

  • Search for ebooks, authors, articles, and reading lists on WeRead.
  • Depends on WeRead API Key and Agent Gateway for authentication.
  • Uses user action and scope parameter to determine search or shelf operation.
  • Returns results as JSON via stdout or API response to the agent.

SKILL.md

.github/skills/weread-skillsView on GitHub ↗
---
name: weread-skills
description: 微信读书助手,可搜索书籍、查看书架、笔记、书评、阅读统计与推荐。
version: 1.0.7
---

# 微信读书 Skill

中文别名:微信读书

该 Skill 使用宿主机 `weread-skills` 能力。API Key 从 `~/.agentdock/env/skill/weread-skills.env` 或当前命令显式环境读取,不包含在 Skill 包中。

## 操作

- `status`:验证 API Key 和微信读书 Agent Gateway 可用性。
- `list-apis`:列出服务端当前支持接口。
- `search`:搜索电子书、作者、文章、书单、听书等。
- `shelf`:读取当前账号书架。
- `call`:调用原生文档声明的任意微信读书接口,业务参数放在 `params` 对象中,入口会自动平铺并附加 `skill_version`。

原始能力文档保存在 `docs/`。

## 辅助脚本执行

Skill 本体是本说明文档。确需调用包内辅助脚本时,在 Skill 包根目录使用相对路径执行;运行宿主负责切换到包根目录并把所需变量注入当前子进程。

```bash
printf '%s' '{"skill_action":"<动作>"}' | python3 run.py
```

输入必须是 JSON 对象。写操作仍按本文档中的确认规则执行。

| 动作 | 用途 |
|---|---|
| `status` | 验证微信读书 API Key 与 Agent Gateway 是否可用。 |
| `list-apis` | 列出微信读书 Agent Gateway 当前支持的接口。 |
| `search` | 搜索微信读书内容;scope=10 电子书,0 全部,16 网文,14 听书,6 作者,12 全文,13 书单,2 公众号,4 文章。 |
| `shelf` | 读取当前微信读书账号书架。 |
| `call` | 调用微信读书原生接口;api_name 必须属于允许的微信读书接口前缀,params 会自动平铺。 |

More from uvwt/agentdock

SkillDescription
baidu-netdiskUse this skill when managing Baidu Netdisk files through the bdpan CLI inside the application data scope.
barkSend Bark-compatible notifications with Python standard library while keeping the device key in the private Skill data environment.
cloudsaverUse this skill when calling the local CloudSaver API for status checks, resource search, Douban hot lists, share parsing, or transfer actions.
code-debriefExplain and teach the core implementation produced by vibecoding from real code, focusing on the main call chain, core code, state and data flow, design reasoning, and transferable engineering knowledge. Use when the user asks to explain, review, learn, debrief, or understand recent code changes, a commit, PR, diff, feature, module, or code path.
codex-usageUse this skill when checking the current macOS user Codex CLI account state or Codex usage quota.
desktopmacOS desktop automation as an AgentDock Skill workflow.
douban-marks只读查询豆瓣电影、图书、音乐标记列表和电影条目联想。用于读取用户自己的已看、想看、在看等标记;公开主页可直接读,私密列表需要本机环境或 .env 中的 DOUBAN_COOKIE。禁止用于批量采集、绕登录、写入标记或读取非授权账号。
douyin-hot获取抖音实时热榜并返回标题、热度和跳转链接。
find-skills-skillSearch and discover OpenClaw skills from various sources. Use when: user wants to find available skills, search for specific functionality, or discover new skills to install.
grok-quotaQuery detailed Grok weekly usage, GrokChat/GrokBuild breakdown, plan, monthly credits, and pay-as-you-go state from local xAI OAuth credentials.