// Search your personal Yuque knowledge bases with natural language queries and provide summarized answers with key points and source links. For personal/individual use — searches across your own documents.
| name | personal-search |
| description | Search your personal Yuque knowledge bases with natural language queries and provide summarized answers with key points and source links. For personal/individual use — searches across your own documents. |
| license | Apache-2.0 |
| compatibility | Requires yuque-mcp server connected to a Yuque account with personal Token |
| metadata | {"author":"chen201724","version":"2.0"} |
Search across your personal Yuque knowledge bases using natural language, read relevant documents, and synthesize a clear answer with references.
All tools are from the yuque-mcp server:
yuque_search — Search documents by keywordyuque_get_doc — Read full document content by slug/idFrom the user's natural language query, extract 1-3 concise Chinese keywords. Yuque search works best with short, specific terms.
Examples:
部署流程错误日志 or 日志处理技术评审Call yuque_search with the extracted keywords:
Tool: yuque_search
Parameters:
query: "<keywords>"
type: "doc"
If the search returns no results:
From the search results, select the top 3-5 most relevant documents based on:
For each selected document, fetch the full content:
Tool: yuque_get_doc
Parameters:
repo_id: "<namespace>" # e.g., "username/my-notes" (from search result's book.namespace)
doc_id: "<slug>" # e.g., "api" (from search result's target.slug)
Note: The search result contains nested data. Extract these key fields:
target.slug → use as doc_idtarget.book.namespace → use as repo_idtarget.title → document titletarget.updated_at → last update timeRead up to 3 documents. If the first document fully answers the question, you may skip the rest.
Compose the answer in the following format:
## 回答
[直接回答用户的问题，2-4 句话，简洁明了]
## 关键要点
- **要点 1**：[从文档中提取的关键信息]
- **要点 2**：[从文档中提取的关键信息]
- **要点 3**：[从文档中提取的关键信息]
## 参考文档
1. [文档标题](文档链接) — 来自「知识库名称」，更新于 YYYY-MM-DD
2. [文档标题](文档链接) — 来自「知识库名称」，更新于 YYYY-MM-DD
> blockquotesteam-search| Situation | Action |
|---|---|
yuque_search returns empty | Try alternative keywords, then inform user |
yuque_get_doc fails (404) | Skip this doc, note it may have been deleted |
yuque_get_doc fails (403) | Tell user they may lack permission to access this doc |
| API timeout | Retry once, then inform user of connectivity issue |
| Too many results | Focus on top 3 by relevance, mention there are more results available |
| User wants to search team docs | Suggest using team-search skill instead |
Generate comprehensive monthly knowledge management reports by analyzing team Yuque activity data including group stats, member contributions, knowledge base health, and document trends. For team use — requires team Token with statistic:read permission.
Format meeting content into structured meeting notes and archive them to a group Yuque knowledge base. For group use — saves to team/group repos. Requires group Token.
Automatically compile a team's core Yuque documents into a structured onboarding reading guide for new group members. For group use — scans group knowledge bases and generates a prioritized reading plan. Requires group Token.
Search group Yuque knowledge bases with natural language queries and provide summarized answers with key points and source links. For group use — searches within team/group repositories. Requires group Token.
Generate technical design documents using a standard template and save them to a group Yuque knowledge base. For group use — stores designs in group repos with review workflow. Requires group Token.
Generate group weekly reports from Yuque activity data including document stats and member contributions. For group use — aggregates team-wide documentation activity. Requires group Token with statistic:read permission.