Instaparser API Skill

Use this skill when the user wants to interact with the Instaparser API to parse articles, PDFs, or generate summaries.

Requirements

• Network access: This skill makes HTTPS requests to https://www.instaparser.com/api/. The user must grant network access when prompted.
• API key: All requests require an Instaparser API key set as the INSTAPARSER_API_KEY environment variable.

Getting an API key

1. Go to https://www.instaparser.com and create an account.
2. After signing in, navigate to the API section of your dashboard to generate an API key.
3. Set the key in your environment:

   export INSTAPARSER_API_KEY="your_api_key_here"
   

4. The free Trial plan includes a limited number of monthly credits. Paid plans are available for higher usage.

Authentication

All API requests require a Bearer token. The API key should be provided via the INSTAPARSER_API_KEY environment variable, or the user can provide it directly.

Authorization: Bearer $INSTAPARSER_API_KEY

API Endpoints

Article API

POST https://www.instaparser.com/api/1/article

Parse an article from a URL and extract its title, author, body content, images, and more. Uses 1 credit per call.

Request body (JSON):

Example:

curl -X POST https://www.instaparser.com/api/1/article \
  -H "Authorization: Bearer $INSTAPARSER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article", "output": "text"}'

Response fields:

PDF API

Parse PDFs from a URL (GET) or by uploading a file (POST). Uses 5 credits per page.

Parse from URL

GET https://www.instaparser.com/api/1/pdf

curl "https://www.instaparser.com/api/1/pdf?url=https://example.com/report.pdf&output=text" \
  -H "Authorization: Bearer $INSTAPARSER_API_KEY"

Upload a file

POST https://www.instaparser.com/api/1/pdf

Send as multipart form-data with a file field.

curl -X POST https://www.instaparser.com/api/1/pdf \
  -H "Authorization: Bearer $INSTAPARSER_API_KEY" \
  -F "file=@report.pdf" \
  -F "output=text"

Response fields: Same as Article API.

Summary API

POST https://www.instaparser.com/api/1/summary

Generate an AI-powered summary with key sentences. Uses 10 credits per call.

Request body (JSON):

curl -X POST https://www.instaparser.com/api/1/summary \
  -H "Authorization: Bearer $INSTAPARSER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

Response fields:

Status Codes

SDK Usage

Python:

from instaparser import InstaparserClient

client = InstaparserClient(api_key="YOUR_API_KEY")

# Article
article = client.Article(url="https://example.com/article", output="text")

# PDF
pdf = client.PDF(url="https://example.com/report.pdf")

# Summary
summary = client.Summary(url="https://example.com/article")

JavaScript:

import { InstaparserClient } from 'instaparser-api';

const client = new InstaparserClient({ apiKey: 'YOUR_API_KEY' });

// Article
const article = await client.article({ url: 'https://example.com/article', output: 'text' });

// PDF
const pdf = await client.pdf({ url: 'https://example.com/report.pdf' });

// Summary
const summary = await client.summary({ url: 'https://example.com/article' });

Instructions

When the user asks to parse an article, PDF, or generate a summary:

1. Check if INSTAPARSER_API_KEY is set in the environment. If not, ask the user for their API key.
2. Use curl via the Bash tool to make the API request.
3. For article parsing, default to output: "text" unless the user specifically wants HTML.
4. For PDF parsing from a local file, use the multipart form-data POST method.
5. For PDF parsing from a URL, use the GET method with query parameters.
6. Present the results clearly — show title, author, word count, and the extracted content.
7. For summaries, display both the overview/summary and the key sentences.