plurk

Read and respond to Plurk timeline content via the Plurk API 2.0.

1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/akhy/agent-skills --skill plurk-akhy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plurk
Source: https://github.com/akhy/agent-skills/tree/main/plurk
Command: npx skills add https://github.com/akhy/agent-skills --skill plurk-akhy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests-oauthlib, and includes scripts (resource) components.

What problem does it solve? Accessing Plurk social network data programmatically requires handling OAuth 1.0 authentication and multiple API endpoints, which is tedious to set up manually for reading timelines or posting responses. ## Core Features & Use Cases - Timeline Reading: Fetch your own timeline with filters (my, responded, private, favorite, replurked, mentioned) or view another user's public plurks. - Response Management: Read responses on any plurk with pagination and post new responses using Plurk qualifiers like says, thinks, or likes. - Use Case: Monitor your Plurk timeline for mentions, then reply to a specific plurk directly from the command line using its plurk_id, with all output as JSON for piping into jq. ## Quick Start Ask the agent to show the latest 10 plurks from your Plurk timeline after setting the four PLURK OAuth environment variables.

Frequently Asked Questions about plurk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read my Plurk timeline from the command line?▼

Run the plurk.py script with the timeline command via uv, optionally passing --limit, --filter, or --offset options. Results are returned as JSON containing plurks and user objects, which you can filter further with jq.

How to post a response to a Plurk using the API?▼

Use the respond command with the plurk_id, a qualifier such as says or likes, and your content text. The script calls the Plurk Responses/responseAdd endpoint and returns the created response as JSON.

What credentials does the Plurk API require?▼

The Plurk API uses OAuth 1.0 and requires four environment variables: PLURK_APP_KEY, PLURK_APP_SECRET, PLURK_AUTH_TOKEN, and PLURK_AUTH_SECRET. The script exits with an error listing any missing variables.

Can I view another user's public plurks without following them?▼

Yes, the public-timeline command fetches public plurks for any user by ID or nickname through the getPublicPlurks endpoint. Only publicly visible plurks are returned, with optional limit and offset parameters.

Why does the Plurk script fail with a missing env vars error?▼

The script checks all four OAuth environment variables before creating a session and exits if any are unset. Export PLURK_APP_KEY, PLURK_APP_SECRET, PLURK_AUTH_TOKEN, and PLURK_AUTH_SECRET in your shell before running it.