Agent skill

pinata

Pin files and JSON to IPFS via Pinata (JWT auth + helper scripts).

Stars 123
Forks 18

Install this agent skill to your Project

npx add-skill https://github.com/z80dev/lemon/tree/main/apps/lemon_skills/priv/builtin_skills/pinata

Metadata

Additional technical details for this skill

lemon
{
    "emoji": "\ud83d\udccc",
    "requires": {
        "bins": [
            "curl"
        ],
        "config": [
            "PINATA_JWT"
        ]
    }
}

SKILL.md

Pinata

Use Pinata to pin content to IPFS.

This skill ships with small scripts (in scripts/) that wrap the Pinata API with reasonable defaults. Prefer PINATA_JWT auth.

Setup

Auth (recommended):

  • Set PINATA_JWT to a Pinata JWT (Bearer token).

Optional (legacy-only, not supported by all endpoints):

  • Set PINATA_API_KEY and PINATA_API_SECRET (some older endpoints accept these).

Optional endpoint overrides:

  • PINATA_API_URL (default: https://api.pinata.cloud)
  • PINATA_UPLOAD_URL (default: https://uploads.pinata.cloud)

Quickstart

Run these from the Pinata skill directory (seeded to ~/.lemon/agent/skill/pinata by default):

Test auth:

bash
./scripts/auth-test.sh

Upload a file (Pinata v3 uploads API):

bash
./scripts/upload-file.sh ./path/to/file.png --network private --name file.png

Pin a JSON document (wraps your JSON as pinataContent):

bash
./scripts/pin-json.sh ./metadata.json --name "metadata.json"

Pin an existing CID (by hash):

bash
./scripts/pin-by-hash.sh bafy... --name "my-cid"

Unpin:

bash
./scripts/unpin.sh bafy...

Notes

  • These scripts print raw JSON responses (so you can pipe into jq if you want).
  • For very large uploads, resumable uploads, or folder uploads, consider Pinata’s official tooling and docs: https://docs.pinata.cloud/

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results