Plurk Trend Skill

Fetch and rank the most-responded-to plurks from your timeline in the last 24 hours.

Depends on the plurk skill for credentials and API access.

Prerequisites

Same env vars as the plurk skill:

export PLURK_APP_KEY="your_consumer_key"
export PLURK_APP_SECRET="your_consumer_secret"
export PLURK_AUTH_TOKEN="your_access_token"
export PLURK_AUTH_SECRET="your_access_secret"

Script

uv run plurk-trend/scripts/plurk_trend.py [--top N] [--since DURATION]

• --top N — number of trending plurks to show (default: 10)
• --since DURATION — time window in Go-style duration (default: 24h)
• --min-responses N — exclude plurks with fewer than N responses (default: 1)

Duration format: combine h (hours), m (minutes), s (seconds) — e.g. 24h, 6h, 1h30m, 90m, 30s

How It Works

1. Paginates through your timeline collecting all plurks within the given time window
2. Excludes plurks with zero responses
3. Sorts remaining plurks by response_count descending
4. Returns the top N

Output Format

JSON array of plurk objects:

[
  {
    "plurk_id": 123456,
    "permalink": "https://www.plurk.com/p/abc1",
    "posted": "Fri, 05 Jun 2009 23:07:13 GMT",
    "plurker": "Alvin Lim (@alvin)",
    "qualifier": "says",
    "content_raw": "Hello world!",
    "content": "Hello world!",
    "response_count": 42
  }
]

Formatting Suggestions

When presenting results to a user, apply these rules:

Content: Use content_raw for plain-text mediums (terminal, chat, markdown). Use content only when the medium renders HTML and inline images.

Plurker name: Already formatted as display_name (@nick_name) in the output.

Responses: Show as a count, e.g. 42 responses.

Permalink: Included in output as permalink — use it to link directly to the plurk.

Example rendered output

#1 — 42 responses
Alvin Lim (@alvin) says:
Hello world!
https://www.plurk.com/p/abc1

#2 — 37 responses
...

jq helpers

# Default top 10, last 24h
uv run plurk-trend/scripts/plurk_trend.py

# Top 5, last 6 hours
uv run plurk-trend/scripts/plurk_trend.py --top 5 --since 6h

# Only plurks with at least 5 responses
uv run plurk-trend/scripts/plurk_trend.py --min-responses 5

# Last 1.5 hours
uv run plurk-trend/scripts/plurk_trend.py --since 1h30m

# Last 90 minutes
uv run plurk-trend/scripts/plurk_trend.py --since 90m

# Plain text summary
uv run plurk-trend/scripts/plurk_trend.py | jq -r '
  to_entries[] |
  "#\(.key + 1) — \(.value.response_count) responses\n\(.value.plurker) \(.value.qualifier):\n\(.value.content_raw)\n\(.value.permalink)\n"
'