AI PDF 自动填充 CLI 工具 - 使用 AI 智能填写 PDF 表单，简化文档处理流程

ai-pdf-filler-cli by askyourpdf/ai-pdf-filler

348 周安装量

1 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/askyourpdf/ai-pdf-filler --skill ai-pdf-filler-cli

AI/机器学习开发生产力

🇨🇳中文介绍

AI PDF Filler CLI

使用已安装的 simplicity-cli 命令执行 PDF 自动填充工作流。当此技能适用时，优先使用直接命令执行而非手动 API 调用。

核心工作流

通过运行 simplicity-cli --help 确认 simplicity-cli 已安装。
如果缺失，安装 CLI：

首选：uv tool install ai-pdf-filler
备用：python3 -m pip install ai-pdf-filler
使用 simplicity-cli --help 重新检查。

确保身份验证可用（在 https://simplicity.ai 创建账户并获取 API 密钥）：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

从带上下文信息的文件创建新表单

simplicity-cli new \
  --form-file ./form.pdf \
  --context "name: John Doe; dob: 1990-07-07"

从带源文档的文件创建新表单

simplicity-cli new \
  --form-file ./form.pdf \
  --source-file ./w2.pdf \
  --source-file ./id.pdf

从 URL 创建新表单

simplicity-cli new \
  --form-url "https://example.com/form.pdf" \
  --source-url "https://example.com/source.pdf"

simplicity-cli existing FORM_ID --context "first_name: John; last_name: Smoke; dob: 1990-07-07"

--context 是用于填充表单字段的源数据。--instructions 仅用于可选的自动填充行为指导。

simplicity-cli status TASK_ID
simplicity-cli wait TASK_ID --poll-interval-seconds 2 --max-wait-seconds 1800

对于 new 命令，强制要求 --form-file 和 --form-url 二选一且仅选其一。
对于 new 命令，要求至少有一个源（--source-file/--source-url）或上下文（--context/--context-file）。
将 --context 和 --context-file 视为互斥。
将 --instructions 和 --instructions-file 视为互斥。
当设置了 --no-download 时，拒绝 --output 参数。

对于交互式运行，使用人类可读的输出模式。
对于自动化或当请求机器可解析的输出时，使用 --json。
仅当用户希望异步交接时使用 --no-wait；否则等待完成。
当用户请求显式文件路径时，使用 --output。

如果未找到 simplicity-cli，请先安装 ai-pdf-filler，然后重试。
如果缺少身份验证，请指导运行 simplicity-cli login（或 --api-key-stdin）或设置 SIMPLICITY_AI_API_KEY。
如果任务失败，报告任务 ID 和失败消息；不要隐藏 API 错误详情。
如果任务成功完成后下载失败，仍返回任务/表单标识符。
对于脚本上下文，使用 --json 重新运行并展示 error.code 和 error.message。

使用 references/commands.md 获取简洁的模板和选项提醒。

🇺🇸English

AI PDF Filler CLI

Execute PDF autofill workflows using the installed simplicity-cli command. Prefer direct command execution over manual API calls when this skill applies.

Core Workflow

Confirm simplicity-cli is installed by running simplicity-cli --help.
If missing, install the CLI:

Preferred: uv tool install ai-pdf-filler
Fallback: python3 -m pip install ai-pdf-filler
Re-check with simplicity-cli --help.

Ensure authentication is available (create an account and get API key at https://simplicity.ai):

Preferred: run simplicity-cli login and paste key in hidden prompt.
Non-interactive: printf '%s' "$SIMPLICITY_AI_API_KEY" | simplicity-cli login --api-key-stdin.
Or set env var: SIMPLICITY_AI_API_KEY.

Choose the autofill path:

New PDF form: use simplicity-cli new.
Existing form id: use simplicity-cli existing FORM_ID.

Wait for completion unless the user explicitly requests async behavior.
Return the resulting task id, form/document id, and downloaded output path.

Command Patterns

Save API key

simplicity-cli login



printf '%s' "$SIMPLICITY_AI_API_KEY" | simplicity-cli login --api-key-stdin

New form from file with context

simplicity-cli new \
  --form-file ./form.pdf \
  --context "name: John Doe; dob: 1990-07-07"

New form from file with source documents

simplicity-cli new \
  --form-file ./form.pdf \
  --source-file ./w2.pdf \
  --source-file ./id.pdf

New form from URL

simplicity-cli new \
  --form-url "https://example.com/form.pdf" \
  --source-url "https://example.com/source.pdf"

Existing form id

simplicity-cli existing FORM_ID --context "first_name: John; last_name: Smoke; dob: 1990-07-07"

--context is the source data used to fill form fields. Use --instructions only for optional autofill behavior guidance.

Task monitoring

simplicity-cli status TASK_ID
simplicity-cli wait TASK_ID --poll-interval-seconds 2 --max-wait-seconds 1800

Rules and Validation

Enforce exactly one of --form-file or --form-url for new.
Require at least one source (--source-file/--source-url) or context (--context/--context-file) for new.
Treat --context and --context-file as mutually exclusive.
Treat --instructions and as mutually exclusive.

Execution Preferences

Use human output mode for interactive runs.
Use --json for automation or when machine-parseable output is requested.
Use --no-wait only when user wants async handoff; otherwise wait to completion.
Use --output when user requests an explicit file path.

Failure Handling

If simplicity-cli is not found, install ai-pdf-filler first, then retry.
If auth is missing, instruct running simplicity-cli login (or --api-key-stdin) or setting SIMPLICITY_AI_API_KEY.
If a task fails, report task id and failure message; do not hide API error details.
If download fails after successful task completion, still return task/form identifiers.
For scripting contexts, rerun with --json and surface error.code and error.message.

References

Use references/commands.md for concise templates and option reminders.

Weekly Installs

3.5K

Repository

askyourpdf/ai-pdf-filler

GitHub Stars

First Seen

14 days ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykFail

Installed on

claude-code3.2K

cursor833

gemini-cli321

github-copilot321

codex321

opencode321

--instructions-file

Reject --output when --no-download is set.

AI PDF 自动填充 CLI 工具 - 使用 AI 智能填写 PDF 表单，简化文档处理流程

🇨🇳中文介绍

AI PDF Filler CLI

核心工作流

相关 Skills

命令模式

保存 API 密钥

从带上下文信息的文件创建新表单

从带源文档的文件创建新表单

从 URL 创建新表单

现有表单 ID

任务监控

规则与验证

执行偏好

故障处理

参考

🇺🇸English

AI PDF Filler CLI

Core Workflow

Command Patterns

Save API key

New form from file with context

New form from file with source documents

New form from URL

Existing form id

Task monitoring

Rules and Validation

Execution Preferences

Failure Handling

References