Mmcp.market

dingtalk-knowledge-search skill

by breath57·breath57/dingtalk-skills·101 stars

钉钉知识库搜索与读取。用于在钉钉沉淀知识里快速查资料、理解项目背景、梳理团队/部门信息、回答制度问题、整理新人入门材料、读取文档正文、导出 Markdown、下载文件，并可带图片和 diagram。

A100/100content scan

Is the dingtalk-knowledge-search skill safe?

Clean: nothing in its files matched our rules. We read 3 files in the folder on 2026-09-28.

No findings.

Install the dingtalk-knowledge-search skill

A skill is a folder. Copy it into your agent's skills folder and the agent loads it when the task matches its description. 

git clone --depth 1 https://github.com/breath57/dingtalk-skills.git /tmp/dingtalk-skills
mkdir -p ~/.claude/skills
cp -r /tmp/dingtalk-skills/.agents/skills/dingtalk-knowledge-search ~/.claude/skills/dingtalk-knowledge-search
available in every project

In the Claude apps, zip the folder and upload it from the Skills settings. The folder on GitHub

The instructions your agent would load

SKILL.md as published, without the frontmatter. Read it on GitHub

用法

cd <the_skill_dir_path>/scripts
python3 cli.py config check
python3 cli.py search "关键词1 关键词2 关键词3"
python3 cli.py read "https://alidocs.dingtalk.com/i/nodes/<node_id>"
python3 cli.py read <node_id>

配置

先运行配置校验：

python3 cli.py config check

需要这些配置：

缺少 DINGTALKMYOPERATOR_ID 时执行：

python3 cli.py config to-unionid

得到什么

  • search：返回匹配文档列表；可用 --limit 控制数量
  • read：返回 Markdown；长内容会写到文件并返回路径；非 ALIDOC 文件会下载原文件
  • PDF 转文本：read --mode pdf2text 会先下载 PDF，再用系统 pdftotext -layout 输出 .txt；如果系统没有 pdftotext，会提示安装 poppler-utils，并退回返回 PDF 路径
  • 默认输出：写到 skill workspace 下的 .skills-workspace/dingtalk-knowledge-search/outputs/
  • 项目沉淀：用 --output-dir "$PWD/dingtalk-docs" --output-path 把结果写到当前项目
  • 输出缓存：下载/转换结果会在用户级缓存目录保留一份，远端 modifiedTime 未变化时复用；默认用硬链接写入 --output-dir，用 --output-strategy copy 可复制隔离
  • 图片本地化：用 --with img-local，图片会下载到 Markdown 同目录 .assets/<文档名>/
  • 图片代理：用 --with img，节约本地空间，但依赖代理服务和原链接有效期
  • diagram：用 --with diagram 一起导出

例子

python3 cli.py search "项目背景 年假 晋升" --limit 10
python3 cli.py read "https://alidocs.dingtalk.com/i/nodes/<node_id>" --output-dir "$PWD/dingtalk-docs" --output-path
python3 cli.py read "https://alidocs.dingtalk.com/i/nodes/<node_id>" --with img-local --with diagram --output-dir "$PWD/dingtalk-docs" --output-path
python3 cli.py read "https://alidocs.dingtalk.com/i/nodes/<file_node_id>" --output-dir "$PWD/dingtalk-docs"
python3 cli.py read "https://alidocs.dingtalk.com/i/nodes/<pdf_node_id>" --mode pdf2text --output-dir "$PWD/dingtalk-docs"
python3 cli.py read "https://alidocs.dingtalk.com/i/nodes/<pdf_node_id>" --mode pdf2text --output-dir "$PWD/dingtalk-docs" --output-strategy copy

缓存

  • search 不缓存，每次直接查远端
  • node、resolve-url、blocks 仍使用 SQLite API 缓存，受 --cache-ttl 影响
  • 输出文件缓存不受 TTL 影响，使用远端 modifiedTime 判断是否复用
  • 输出缓存默认位置：~/.dingtalk-skills/dingtalk-knowledge-search/output-cache/
  • 默认 --output-strategy link：把全局缓存硬链接到当前 --output-dir，节省空间；编辑任一硬链接文件会影响同一份内容
  • --output-strategy copy：复制到当前 --output-dir，和全局缓存隔离
  • python3 cli.py cache clear --namespace output --yes 会删除输出缓存记录和关联本地文件

登录

  • 需要扫码时，命令会返回 loginRequired: true 和 screenshotPath
  • 扫码后重新执行同一个命令

More skills from breath57/dingtalk-skills

  • Adingtalk-ai-table钉钉 AI 表格（多维表格）操作。当用户提到"钉钉AI表格"、"AI表格"、"多维表格"、"工作表"、"字段"、"记录"、"新增记录"、"查询记录"、"更新记录"、"删除记录"、"新建字段"、"删除字段"、"dingtalk AI table"、"dingtalk notable"、"able文件"时使用此技能。支持工作表管理、字段管理、记录的增删改查等全部操作。
  • Adingtalk-ai-web-search网页搜索与实时信息检索。需要查找最新资讯、实时数据、技术文档、热点事件，或用户说"搜一下"、"帮我查"、"查资料"、"web search"等时使用。基于小宿AI智能搜索，支持关键词搜索、时间范围过滤（一天/一周/一月/一年）、自定义结果数量、JSON 输出。
  • Adingtalk-calendar钉钉日程与日历。当用户提到"钉钉日程"、"日历"、"创建日程"、"新建会议"、"视频会议"、"钉钉会议"、"会议室"、"约会议室"、"会议室忙闲"、"空闲会议室"、"签到"、"签退"、"签到链接"、"签退链接"、"循环日程"、"重复日程"、"recurrence"、"查日程"、"日程列表"、"修改日程"、"删除日程"、"闲忙"、"忙闲"、"querySchedule"、"calendar"、"dingtalk schedule"、"日程提醒"时使用此技能。支持：主日历下日程 CRUD、用户闲忙、视频会议、会议室忙闲与绑定日程、签到/签退与链接、循环规则（recurrence）；订阅公共日历等需 Calendar.Calendar.Write 的能力见 api.md。
  • Adingtalk-contact钉钉通讯录与联系人查询。当用户提到"钉钉通讯录"、"查找员工"、"搜索用户"、"查用户信息"、"获取用户详情"、"用户手机号"、"员工姓名"、"员工工号"、"查部门"、"搜索部门"、"部门成员"、"部门列表"、"部门详情"、"子部门"、"父部门"、"部门路径"、"员工总数"、"通讯录搜索"、"userId 转 unionId"、"unionId 转 userId"、"dingtalk contact"、"dingtalk directory"、"find user"、"get user info"、"department members"时使用此技能。支持：按关键词搜索用户/部门、获取用户完整信息（姓名/手机/工号/部门/职位/unionId）、获取部门成员列表、获取部门树结构、查询用户所在部门路径、员工总人数统计等全部通讯录操作。
  • Adingtalk-document钉钉知识库和文档管理操作。当用户提到"钉钉文档"、"知识库"、"新建文档"、"查看文档目录"、"读取文档内容"、"写入文档"、"更新文档"、"文档成员"、"dingtalk doc"、"knowledge base"时使用此技能。支持：创建知识库、查询知识库列表、新建文档/文件夹、读取/写入文档正文内容、管理成员权限等全部文档类操作。
  • Adingtalk-message钉钉消息发送。当用户提到"钉钉消息"、"发消息"、"发通知"、"群通知"、"群消息"、"Webhook"、"机器人消息"、"机器人发消息"、"工作通知"、"单聊消息"、"群聊消息"、"撤回消息"、"消息已读"、"发送Markdown"、"发卡片消息"、"ActionCard"、"@某人"、"@员工"、"at某人"、"提醒某人"、"dingtalk message"、"send message"、"robot message"、"work notification"时使用此技能。支持：群自定义 Webhook 机器人（文本/Markdown/ActionCard/Link/FeedCard + 加签 + @某人）、企业内部应用机器人单聊和群聊发送、消息撤回、已读查询、工作通知等全部消息类操作。
  • Adingtalk-skill-creator创建新的钉钉技能（dingtalk skill）。当用户提到"创建新技能"、"新建技能"、"开发钉钉技能"、"新增钉钉功能"、"添加钉钉接口支持"、"我需要一个钉钉 xxx 技能"、"钉钉待办"、"钉钉签到"、"钉钉考勤"、"钉钉审批"、"钉钉日程"等希望将某个钉钉 API 领域封装成可复用 skill 时，必须使用此技能。此技能包含完整的技能创建流程：SDK 探索 → SDK Python 测试 → 纯 HTTP Python 测试（两步全通过）→ SKILL.md 编写。测试未全部通过不得创建 skill。
  • Adingtalk-todo钉钉待办管理。当用户提到"钉钉待办"、"待办任务"、"创建待办"、"新增待办"、"查看待办"、"完成待办"、"标记完成"、"删除待办"、"待办列表"、"我的待办"、"设置截止时间"、"指派待办"、"dingtalk todo"、"todo task"、"task management"时使用此技能。支持：创建待办（含描述/截止时间/优先级/参与者）、获取详情、查询列表（按完成状态过滤）、更新待办、标记完成、删除待办等全部待办类操作。
  • Askill-creatorCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

All agent skills → · MCP servers