核心用法
pdf-co 是一个纯文档型技能（T-MD分类），提供对 PDF.co API 的完整使用指南。用户通过 Maton 平台代理访问 PDF.co 服务，无需直接管理 PDF.co 的 API 密钥，仅需配置 MATON_API_KEY 环境变量。
主要功能覆盖：
- 格式转换：PDF ↔ Text、CSV、JSON、HTML、Excel(XLSX)、PNG、JPG，以及 HTML/URL 转 PDF
- 文档处理：合并多PDF、按页拆分、删除指定页面
- 内容编辑：添加文本/图片水印、搜索替换文本、搜索删除文本
- 安全操作：添加/移除密码保护
- 智能解析：AI发票解析器、模板化文档解析器
- 条码处理：生成和读取各类条码（QRCode、Code128等）
技术实现：所有请求通过 https://api.maton.ai/pdf-co/{native-api-path} 代理转发，Maton 自动注入用户凭证。支持同步和异步（async）处理模式，大文件建议采用异步避免超时。
显著优点
1. 托管认证简化流程：无需单独注册 PDF.co 账号，通过 Maton 统一身份管理，支持多连接切换（Maton-Connection 头）
2. 功能全面：覆盖 PDF 生命周期的绝大多数操作，从格式转换到 AI 驱动的发票数据提取
3. 安全密钥管理：API Key 通过环境变量传递，无硬编码风险，符合安全最佳实践
4. 零本地依赖：纯文档型技能，无运行时依赖，跨平台兼容
5. 详细示例：提供 Bash、Python、JavaScript 多语言调用示例
潜在缺点与局限性
1. 网络强依赖：所有操作必须联网，无法离线使用
2. 第三方服务依赖：文档内容需上传至 PDF.co/Maton 服务器处理，存在数据出境风险
3. 临时文件过期：输出文件默认 60 分钟后过期，需及时下载
4. T3来源可信度：由个人开发者（byungkyu）维护，非企业级 SLA 保障
5. 成本考量：PDF.co 按积分计费（credits），高频使用需关注成本
6. 页面索引混淆：采用 0-based 索引（首页为0），与常见 1-based 习惯不同
适合人群
- 需要批量处理 PDF 的自动化脚本开发者
- 希望快速集成 PDF 功能而无需自建基础设施的初创团队
- 需要发票/合同自动化的财务/运营人员
- 已将 Maton 纳入技术栈的现有用户
常规风险
1. 数据隐私：敏感文档（合同、病历、财务报告）上传至第三方云服务，需评估合规性
2. 服务可用性：依赖 Maton 和 PDF.co 双服务的稳定性
3. 授权凭证泄露：MATON_API_KEY 泄露可能导致账户被滥用
4. 误操作风险：写操作（编辑、删除、合并）不可逆，虽有"需用户确认"声明，但实际执行仍需谨慎