A robust skill for managing Instapaper bookmarks, highlights, and folders via the command line with structured data output.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install instapaper
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install instapaper using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Instapaper CLI?
This skill enables developers and power users to interface with Instapaper directly through the ip CLI tool. It facilitates seamless authentication, listing, exporting, and importing of bookmarks, making it an essential component for any automated reading workflow within the Openclaw Skills ecosystem. By providing a bridge between the command line and Instapaper's API, it allows for sophisticated data manipulation and synchronization without needing a browser.
Instapaper CLI Use Cases
- Syncing reading lists to local databases or markdown files for knowledge management.
- Bulk managing Instapaper folders and highlights via scripted automation.
- Exporting article text for offline processing, archival, or LLM training data ingestion.
- Programmatic authentication and health checks for automated Instapaper account maintenance.
How Instapaper CLI Works
- Verify the local environment by checking for required API keys and running diagnostic commands like ip doctor.
- Authenticate the user securely using password-stdin to ensure credentials are never stored in shell history.
- Fetch reading data deterministically using specific flags like cursors or time-based bounds for incremental synchronization.
- Process or export content in structured formats such as NDJSON or JSON to feed into other Openclaw Skills or external tools.
- Execute mutations, folder organization, or highlight management safely using dry-run modes and idempotent flags.
Instapaper CLI Setup
To get started with this skill, you must first install the CLI tool using one of the following methods:
# Via Go
go install github.com/vburojevic/instapaper-cli/cmd/ip@latest
# Via Homebrew
brew tap vburojevic/tap && brew install instapaper-cli
Next, ensure your environment is configured by setting the INSTAPAPER_CONSUMER_KEY and INSTAPAPER_CONSUMER_SECRET environment variables. This setup is vital for Openclaw Skills to communicate effectively with the Instapaper API.
Instapaper CLI Data Schema & Taxonomy
The skill prioritizes structured data for automation, supporting several output formats to integrate with various workflows. Data can be organized according to the following schema:
| Format | Description | Best Use Case |
|---|---|---|
| --ndjson | Newline Delimited JSON | Streaming large datasets and logs |
| --json | Standard JSON Array | Single object retrieval or compact data |
| --plain | Tab-separated values | Stable, line-oriented text for shell scripts |
| --stderr-json | Error objects | Reliable automation error handling |
Instapaper CLI Advanced Features
- Cursor-based synchronization support for efficient incremental updates and large-scale data fetching.
- Structured error reporting via stderr-json to allow automation scripts to map exit codes to specific actions.
- Client-side filtering using the --select flag to provide granular control when the API does not support native filtering.
- Idempotent mutations and bulk action support via stdin and batch flags for high-volume bookmark management.
SKILL.md
Loading
Related Openclaw Skills
Valiron Payment Interceptor
A trust-based middleware for AI agents to authorize, throttle, or block outgoing payments based on counterparty risk and custom spend policies.
ClawHub CLI
A dedicated command-line interface for searching, installing, and publishing agent capabilities within the Openclaw ecosystem.
Fitness & Wellness Coach
A privacy-conscious AI coach that transforms fitness app screenshots into evidence-based training, nutrition, and recovery protocols.
openclaw-bee
A persistent structured memory engine that enables AI agents to retain, deduplicate, and recall beliefs across sessions.
Weather Open-Meteo
A high-performance weather skill providing real-time atmospheric data and multi-day forecasts via Open-Meteo and wttr.in without requiring API keys.
OpenReview Review Analyzer
An automated research tool that fetches, aggregates, and synthesizes peer reviews from OpenReview into structured analytical reports.
METADATA
Featured*
