---
slug: merge-pdf
name: merge-pdf
version: "1.0.0"
displayName: Merge PDF
summary: "上传多PDF到Cross-Service-Solutions合并,轮询至完成"
  polling unti...
license: MIT
description: |-
  Merge multiple user-provided PDF files by uploading them to Cross-Service-Solutions,
  polling unti。Use when 需要文件处理、文档转换、格式互转、内容提取时使用。不适用于加密文件破解。适用于独立开发者、企业团队和自动化工作流场景。
tags:
- Knowledge
tools:
  - - read
- exec
pricing_tier: "L4"
pricing_model: "monthly"
suggested_price: 99.9
---


# Merge PDF

## Purpose

This skill merges multiple PDFs by:

1. accepting multiple PDF files from the user,
2. uploading them to the Cross-Service-Solutions merge API,
3. polling the job status until it is finished,
4. returning the merged PDF download URL.

## Credentials

The API requires an API key used as a Bearer token:

* `Authorization: Bearer <API_KEY>`

How the user gets an API key:

* <https://login.cross-service-solutions.com/register>
* Or the user can provide an API key directly.

**Rule:** never echo or log the API key.

## API endpoints

Base URL:

* `https://api.xss-cross-service-solutions.com/solutions/solutions`

Create merge job:

* `POST /api/30`
* `multipart/form-data` parameters:
  + `files` (PDF Dokument) — required — multiple PDF files (multiple_files)

Get result by ID:

* `GET /api/<ID>`

When done, the response contains:

* `output.files[]` with `{ name, path }` where `path` is a downloadable URL.

## Inputs

### Required

* One or more PDF files (binary)
* An API key (string)

### Optional

* None (ordering is determined by the provided file list order)

## Output

Return a structured result:

* `job_id` (number)
* `status` (string)
* `download_url` (string, when done)
* `file_name` (string, when available)
* `input_files` (array of strings)

Example output:

```json
{
  "job_id": 456,
  "status": "done",
  "download_url": "https://.../merged.pdf",
  "file_name": "merged.pdf",
  "input_files": ["a.pdf", "b.pdf", "c.pdf"]
}
```

## 依赖说明

### 运行环境
- **Agent平台**: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- **操作系统**: Windows / macOS / Linux

### 依赖说明
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-------|:-----|:---------|:---------|
| LLM API | API | 必需 | 由Agent内置LLM提供 |

### API Key 配置
- 本Skill基于Markdown指令,无需额外API Key(除内容中明确标注的外部API)

### 可用性分类
- **分类**: MD+EXEC(纯Markdown指令,部分功能需要exec命令行执行能力)
- **说明**: 基于Markdown的AI Skill,通过自然语言指令驱动Agent执行任务

## 核心能力

- Merge multiple user-provided PDF files by uploading them to Cross-Service-Solutions,
  polling unti
- 触发关键词: merge, files, pdf, multiple, provided

## 适用场景

| 场景 | 输入 | 输出 |
|------|------|------|
| 基础使用 | 用户请求 | 处理结果 |

**不适用于**：需要人工判断的复杂决策场景

## 使用流程

1. 确认运行环境满足依赖说明中的要求
2. 根据适用场景选择合适的使用方式
3. 执行操作并检查输出结果
4. 如遇错误，参考错误处理章节

## 示例

### 示例1：基础用法

```
输入: 用户请求
处理: 根据使用流程执行
输出: 处理结果
```

## 错误处理

| 错误场景 | 原因 | 处理方式 |
|---------|------|---------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 检查网络连接后重试，参考国内替代方案 |

## 常见问题

### Q1: 如何开始使用Merge PDF？
A: 请先阅读使用流程章节，确认环境满足依赖说明中的要求。

### Q2: 遇到错误怎么办？
A: 请参考错误处理章节，按照表格中的处理方式操作。

### Q3: Merge PDF有什么限制？
A: 请参考已知限制章节了解具体限制。

## 已知限制

- 需要LLM支持，无LLM环境无法使用
- 复杂场景可能需要人工辅助判断
- 性能取决于底层模型能力