> ## Documentation Index
> Fetch the complete documentation index at: https://docs.somark.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# SoMark Skill

> 在 Claude Code、Cursor、Cline 等 AI 编程助手中，使用 somark-document-parser Skill 解析文档

[somark-document-parser](https://github.com/SoMarkAI/somark-document-parser) 适合在支持 Skill 的 Agent 平台里直接复用 SoMark 的解析能力，不必自己再封装上传、调用和结果读取逻辑。如果你还在比较 Skill、MCP、API、CLI、SDK 的路径差异，先看 [入门总览](/documentation/get-started-overview)。

<Steps>
  <Step title="安装">
    你可以从以下来源安装：

    **GitHub**

    ```bash theme={null}
    npx skills add https://github.com/SoMarkAI/somark-document-parser
    ```

    **skills.sh**

    ```bash theme={null}
    npx skills add https://github.com/somarkai/somark-document-parser --skill somark-document-parser
    ```

    **clawhub.ai / OpenClaw**

    ```bash theme={null}
    openclaw skills install somark-document-parser
    ```

    兼容 Claude Code、Cursor、Cline、OpenCode 及 [40+ 其他 AI 编程助手](https://skills.sh)。
  </Step>

  <Step title="配置 API Key">
    前往 [somark.tech](https://somark.tech) 获取 API Key，然后设置环境变量：

    ```bash theme={null}
    export SOMARK_API_KEY=sk-your-api-key
    ```

    也可以在 Agent 设置中配置。首次使用时，Skill 会自动引导你完成配置。

    <Note>
      SoMark 提供免费解析额度（每日 500 页、每月 2000 页），会自动发放到账户，超出后系统会自动改为消耗付费用量。
    </Note>
  </Step>

  <Step title="用更明确的指令触发 Skill">
    为了更稳定地触发 SoMark skill，指令里最好同时说清楚要处理的文件、要执行的解析动作、你想要的输出形式：

    * "用 SoMark 解析这个 PDF，并输出 Markdown。"
    * "调用 SoMark skill 解析这份合同，提取关键条款并保留标题层级。"
    * "调用 SoMark 解析这份论文，告诉我这篇论文的核心思想。"
  </Step>

  <Step title="留意使用限制">
    当前默认限制如下：

    | 限制项    | 上限     |
    | ------ | ------ |
    | 单文件大小  | 200 MB |
    | 单文件页数  | 300 页  |
    | 账号 QPS | 1      |
  </Step>
</Steps>