← Back to Skills Marketplace
thistine

Paperless Api

by ThisTine · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ⚠ suspicious
100
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install paperless-api
Description
Upload and categorize documents using the Paperless-ngx API. Use for automating document management tasks with your Paperless-ngx instance.
Usage Guidance
This skill does what it claims: it uploads documents to Paperless-ngx. Before installing/using it: (1) review the script yourself (it is included) to verify it meets your needs; (2) avoid passing API keys on the command line—use environment variables, a config file with tight permissions, or another secrets mechanism; (3) fix or remove verify=False so TLS certs are validated (or ensure you use a trusted HTTPS endpoint); (4) confirm the host URL points to your Paperless instance and not an unknown remote host; (5) be aware the script prints response JSON to stdout—don't run it with sensitive output redirected where others can read it.
Capability Analysis
Type: OpenClaw Skill Name: paperless-api Version: 0.1.0 The skill provides a utility to upload documents to a Paperless-ngx instance via `scripts/upload_document.py`. It is classified as suspicious because the script explicitly disables SSL certificate verification (`verify=False`) when making API requests. This is a significant security vulnerability that could allow for the interception of sensitive API keys and document data through Man-in-the-Middle (MITM) attacks. While this behavior may be intended to support self-signed certificates in home environments, it constitutes a high-risk flaw according to security best practices.
Capability Assessment
Purpose & Capability
Name/description match the included code and instructions: the SKILL.md and scripts/upload_document.py both implement document upload and basic categorization via the Paperless-ngx API. No unrelated services, binaries, or credentials are requested.
Instruction Scope
Instructions are narrowly scoped: run the included Python script with --host and --api_key and optional metadata. Notable issues: the script disables TLS certificate verification (requests.post(..., verify=False)), and the SKILL.md demonstrates passing the API key on the command line (which can expose secrets in process lists or shell history). These are security/hygiene concerns but not evidence of malicious or incoherent behavior.
Install Mechanism
There is no install spec (instruction-only with a small helper script). No downloads or package installs are performed by the skill, so there is minimal install-time risk.
Credentials
The skill requires an API key and host to function, but these are provided as command-line arguments rather than declared environment variables. The requested credentials are proportional to the stated purpose. Consider that passing secrets on the CLI is less safe than using environment variables or a secrets store.
Persistence & Privilege
The skill does not request persistent platform privileges (always is false). It does not modify other skills or system configuration and does not require elevated/system-wide access.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install paperless-api
  3. After installation, invoke the skill by name or use /paperless-api
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of the Paperless API skill. - Upload and categorize documents in your Paperless-ngx instance via API. - Supports custom titles, tags, and document types on upload. - Simple configuration with host URL and API key. - Includes a command-line script for document upload automation.
Metadata
Slug paperless-api
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Paperless Api?

Upload and categorize documents using the Paperless-ngx API. Use for automating document management tasks with your Paperless-ngx instance. It is an AI Agent Skill for Claude Code / OpenClaw, with 100 downloads so far.

How do I install Paperless Api?

Run "/install paperless-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Paperless Api free?

Yes, Paperless Api is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Paperless Api support?

Paperless Api is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Paperless Api?

It is built and maintained by ThisTine (@thistine); the current version is v0.1.0.

💬 Comments