跳转到主要内容
somark-document-parser 适合在支持 Skill 的 Agent 平台里直接复用 SoMark 的解析能力,不必自己再封装上传、调用和结果读取逻辑。如果你还在比较 Skill、MCP、API、CLI、SDK 的路径差异,先看 入门总览
1

安装

你可以从以下来源安装:GitHub
npx skills add https://github.com/SoMarkAI/somark-document-parser
skills.sh
npx skills add https://github.com/somarkai/somark-document-parser --skill somark-document-parser
clawhub.ai / OpenClaw
openclaw skills install somark-document-parser
兼容 Claude Code、Cursor、Cline、OpenCode 及 40+ 其他 AI 编程助手
2

配置 API Key

前往 somark.tech 获取 API Key,然后设置环境变量:
export SOMARK_API_KEY=sk-your-api-key
也可以在 Agent 设置中配置。首次使用时,Skill 会自动引导你完成配置。
SoMark 提供免费解析额度(每日 500 页、每月 2000 页),会自动发放到账户,超出后系统会自动改为消耗付费用量。
3

用更明确的指令触发 Skill

为了更稳定地触发 SoMark skill,指令里最好同时说清楚要处理的文件、要执行的解析动作、你想要的输出形式:
  • “用 SoMark 解析这个 PDF,并输出 Markdown。”
  • “调用 SoMark skill 解析这份合同,提取关键条款并保留标题层级。”
  • “调用 SoMark 解析这份论文,告诉我这篇论文的核心思想。”
4

留意使用限制

当前默认限制如下:
限制项上限
单文件大小200 MB
单文件页数300 页
账号 QPS1