# PDF文件正文抽取：官方指南总目录
**PDF文件正文抽取** 是万维易源（昆明秀派科技）提供的免费 API，支持将 PDF 文件中的文字内容抽取出来，便于编辑、复制、搜索与分析，常用于学术文献研究、企业文档数字化、个人资料整理等场景。本目录汇总了从快速上手到生态集成的全系列官方指南，帮助你按需求与阅读顺序取用。
## 全系列文章（共 9 篇）
### 入门层
1. **[PDF文件正文抽取：5 分钟从注册到跑通第一条抽取结果](https://www.showapi.com/guides/pdf-extract-quickstart-10)**
注册、获取 AppKey、第一次调用、解析返回的 `text` 字段，附带可直接运行的 Python / cURL / Node.js 代码。
2. **[PDF文件正文抽取：返回字段全解（text / ret_code / remark）](https://www.showapi.com/guides/pdf-extract-response-10)**
拆解系统级 `showapi_res_code` 与业务级 `showapi_res_body` 三字段结构与排查路径。
### 场景实战层
3. **[PDF文件正文抽取：学术论文与文献 PDF 批量抽取实战](https://www.showapi.com/guides/pdf-extract-academic-10)**
遍历论文目录、逐份上传、落盘为 TXT，并做并发限流避免触发免费档位限制。
4. **[PDF文件正文抽取：企业合同与文档数字化整理方案](https://www.showapi.com/guides/pdf-extract-document-10)**
合同/报告 PDF 抽取正文入库，结合 `text` 做全文检索的设计要点。
### 技术深挖层
5. **[PDF文件正文抽取：把抽取结果转存为 TXT / DOCX](https://www.showapi.com/guides/pdf-extract-export-10)**
拿到 `text` 后如何在客户端保存为 TXT 或 DOCX，处理编码与分段落换行。
6. **[PDF文件正文抽取：免费档位限制与频率/成本控制](https://www.showapi.com/guides/pdf-extract-free-tier-10)**
理解免费调用的「使用档次限制」，用本地缓存与队列限速稳定使用。
### 最佳实践层
7. **[PDF文件正文抽取：能力边界与避坑（扫描件/特殊排版如何处理）](https://www.showapi.com/guides/pdf-extract-limits-10)**
如实说明接口定位与边界情形，给出可落地的应对思路，不夸大能力。
### 生态集成层
8. **[PDF文件正文抽取：通过 MCP 在 AI 客户端直接调用](https://www.showapi.com/guides/pdf-extract-mcp-10)**
基于官方 MCP 配置，在 Cherry Studio / ChatBox 等客户端中直接调用。
9. **[PDF文件正文抽取：导入 Postman / Swagger 用 OpenAPI 文档管理接口](https://www.showapi.com/guides/pdf-extract-openapi-10)**
下载 OpenAPI 3.0 文档，导入 Postman / Swagger UI 自动生成请求模板与 Mock。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页（apiCode=10） | https://www.showapi.com/apiGateway/view/10 |
| 接入点（10-1） | https://www.showapi.com/apiGateway/view/10/1 |
| OpenAPI YAML | https://www.showapi.com/openapi/market/10.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/10.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费 API 档位说明 | https://www.showapi.com/free-api |
| 使用向导（帮助手册） | https://www.showapi.com/helpcenter/view#/3960/1 |
## 阅读建议
- 第一次使用：从 **第 1 篇快速开始** 跑通调用，再看 **第 2 篇返回字段全解** 理解数据结构。
- 做批量/企业场景：优先看 **第 3、4 篇** 场景实战，配合 **第 6 篇免费档位** 控制成本。
- 想接入 AI 工作流：直接看 **第 8 篇 MCP 集成** 与 **第 9 篇 OpenAPI 导入**。
- 遇到结果不符合预期：先查 **第 7 篇能力边界与避坑**。
