Skip to content
TakoAPI
Back to skills

pinata-api

by iammatthias

Search & Research
695Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Pinata IPFS API for file storage, groups, gateways, signatures, x402 payments, and file vectorization.

Description

What This Skill Does

Provides access to Pinata's IPFS storage API. Covers file uploads, group management, gateway configuration, EIP-712 content signatures, x402 micropayment setup, and AI-powered vector search across stored files.

Combines IPFS pinning, access control, payments, and vector search in one API instead of stitching together separate services.

When to Use It

  • Uploading and organizing files on IPFS with metadata tags
  • Generating temporary signed URLs for private file access
  • Setting up pay-per-access IPFS content with USDC on Base
  • Running semantic search over a collection of stored documents
  • Pinning existing IPFS CIDs to a Pinata account

Example Workflow

INPUT

User asks: upload a file to a private IPFS group and return a temporary download link

AGENT
  1. 1

    Upload the file via POST to uploads.pinata.cloud/v3/files with network=private and the target group_id

  2. 2

    Retrieve the file's CID from the upload response

  3. 3

    POST to api.pinata.cloud/v3/files/private/download_link with the gateway URL, expiry, and current Unix timestamp

  4. 4

    Return the signed URL to the user

OUTPUT

A temporary signed URL valid for the specified duration that grants access to the private file

Requirements

  • PINATA_JWT environment variable (get from app.pinata.cloud/developers/api-keys)
  • PINATA_GATEWAY_URL environment variable (find at app.pinata.cloud/gateway)
  • Pinata account

Installation

clawhub install iammatthias/pinata-api

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links