make-pdf-safe

# make-pdf-safe

## Purpose
This skill creates a “safe” PDF by converting the document into a single flattened layer without active functionality. The goal is to reduce risk from interactive PDF features.

In practical terms, the output PDF is intended to:
- remove or neutralize interactive elements (e.g., scripts/actions),
- prevent editing of underlying objects/content structure,
- behave like a flattened document layer (similar to a “print” representation).

This skill:
1) accepts a PDF file from the user,
2) uploads it to the Solutions API,
3) polls the job status until it is finished,
4) returns the download URL for the “safe” flattened PDF.

## 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 make-safe job:
- `POST /api/41`
- `multipart/form-data` parameters:
  - `file` — required — PDF file

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
- PDF file (binary)
- API key (string)

### Optional
- None

## Output
Return a structured result:
- `job_id` (number)
- `status` (string)
- `download_url` (string, when done)
- `file_name` (string, when available)

Example output:
```json
{
  "job_id": 4101,
  "status": "done",
  "download_url": "https://.../safe.pdf",
  "file_name": "safe.pdf"
}

---

## `README.md`

```md
# make-pdf-safe (OpenClaw Skill)

Create a “safe” PDF by flattening the document into a single, non-interactive layer via the Solutions API.

## What “safe” means here
This tool is meant to reduce risk from PDFs that contain interactive or active features.

The output PDF is intended to behave like a flattened representation:
- interactive features such as embedded actions/scripts are removed or neutralized,
- the document is converted into a non-editable-like layer (no underlying object structure to modify),
- content is preserved visually, but active functionality should not remain.

This is useful when you want to share or archive a PDF while minimizing the chance that:
- scripts/actions can run,
- forms/objects can be edited to change the document content structure.

## What you need
- A PDF file
- A Solutions API key (Bearer token)
  - Register / get key: https://login.cross-service-solutions.com/register

## How it works
1) Upload PDF to:
   `POST https://api.xss-cross-service-solutions.com/solutions/solutions/api/41`
2) Poll:
   `GET  https://api.xss-cross-service-solutions.com/solutions/solutions/api/<job_id>`
3) Return `output.files[0].path` as the download URL

## Script (CLI)
```bash
python scripts/make_pdf_safe.py \
  --pdf "/path/to/file.pdf" \
  --api-key "$SOLUTIONS_API_KEY"