plurk-trend

Ranks Plurk timeline posts by response count within a configurable time window.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Finding the most-discussed posts on Plurk requires manually scrolling through the timeline and counting responses, which is slow and error-prone when you want to spot viral or popular content quickly. ## Core Features & Use Cases - Trending Ranking: Fetches plurks from your timeline and ranks them by response count in descending order. - Flexible Time Windows: Filter by Go-style durations like 24h, 6h, or 1h30m, and set a minimum response threshold. - Structured JSON Output: Returns plurk ID, permalink, author, content, and response count, ready for jq pipelines or chat formatting. - Use Case: Run a daily digest to surface the top 10 most-responded plurks from the last 24 hours and share the highlights with your community. ## Quick Start Show me the top 10 trending plurks from my timeline over the last 24 hours ranked by number of responses.

Frequently Asked Questions about plurk-trend

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

FAQPage Schema
How do I find trending plurks on Plurk?▼

Run the plurk_trend.py script with uv to fetch your timeline and rank plurks by response count. Use --top to set how many results to return and --since to control the time window, such as 24h or 6h.

How to filter Plurk posts by time window in Python?▼

Pass a Go-style duration like 24h, 1h30m, or 90m to the --since flag. The script paginates the Plurk Timeline API and stops once posts fall outside the cutoff, collecting only plurks within the window.

What credentials does the Plurk API require?▼

The Plurk API uses OAuth 1.0a 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.

Why does the Plurk trending script return no results?▼

Empty output usually means no plurks in the window met the minimum response threshold, which defaults to 1. Lower the time window with --since or check that your OAuth credentials are valid and the timeline has recent activity.

Can I exclude plurks with few responses from the results?▼

Yes, use the --min-responses flag with a positive integer to exclude plurks below that response count. For example, --min-responses 5 keeps only plurks with at least five responses.