{ "name": "Royal Road Rising Stars History", "description": "Historical analytics platform tracking Royal Road's Rising Stars fiction rankings since September 2023. Provides current and historical leaderboard data, fiction ranking histories, genre/tag list membership, publishing cohort analysis, and market churn metrics across 1,478 tracked fictions and 15,000+ snapshots.", "version": "1.0.0", "provider": { "organization": "DoomLabs", "url": "https://rst.doomlabs.net" }, "documentationUrl": "https://rst.doomlabs.net/openapi.json", "iconUrl": "https://rst.doomlabs.net/favicon.svg", "supportedInterfaces": [ { "url": "https://rst.doomlabs.net/api", "protocolBinding": "HTTP+JSON", "protocolVersion": "1.0" } ], "capabilities": { "streaming": false, "pushNotifications": false, "extendedAgentCard": false }, "defaultInputModes": ["application/json", "text/plain"], "defaultOutputModes": ["application/json"], "skills": [ { "id": "current-rankings", "name": "Current Rising Stars Rankings", "description": "Get the current Royal Road Rising Stars top 50 with rank and follower deltas compared to the previous snapshot and 24 hours ago. Includes badges for new entries, fast movers, and long-tenured fictions.", "tags": ["rankings", "royal-road", "rising-stars", "leaderboard", "current"], "examples": [ "What are the current Rising Stars rankings?", "Which fictions are trending on Royal Road right now?", "What moved up the most in the last 24 hours?" ] }, { "id": "historical-rankings", "name": "Historical Rankings Lookup", "description": "Retrieve Rising Stars rankings at any point in time since September 2023 using a snapshot ID or timestamp. Supports relative lookups like '6 hours ago' via the /rising-stars page.", "tags": ["historical", "rankings", "snapshot", "time-travel", "royal-road"], "examples": [ "What were the Rising Stars rankings on June 15, 2024?", "Show me the leaderboard from last week.", "Get snapshot ID 4821." ] }, { "id": "snapshot-comparison", "name": "Snapshot Comparison", "description": "Compare two snapshots to identify new entries, fictions that dropped off, and the biggest rank movers. Returns top 10 movers in each direction plus full movement data.", "tags": ["comparison", "delta", "movement", "snapshots", "changes"], "examples": [ "What changed between snapshot 4800 and 4850?", "Which fictions entered the top 50 this week?", "Show me the biggest rank changes between two dates." ] }, { "id": "fiction-ranking-history", "name": "Fiction Ranking History", "description": "Get the complete Rising Stars ranking history for a specific fiction by its Royal Road ID. Returns every snapshot it appeared in, peak rank, worst rank, follower growth, and trend direction.", "tags": ["fiction", "history", "ranking", "trends", "followers", "royal-road"], "examples": [ "Show me the ranking history for fiction 138753.", "What is the best rank this fiction has ever achieved?", "Is this fiction's rank improving or declining?" ] }, { "id": "genre-tag-membership", "name": "Genre and Tag List Membership", "description": "Check which of the 79 Rising Stars lists (main list + 16 genre lists + 63 tag lists) a fiction currently appears on, along with its position on each. Data refreshed hourly.", "tags": ["genre", "tags", "lists", "membership", "rising-stars", "royal-road"], "examples": [ "Which Rising Stars lists does fiction 138753 appear on?", "Is this fiction on the LitRPG Rising Stars list?", "What position is this fiction on the Fantasy list?" ] }, { "id": "cohort-analysis", "name": "Publishing Cohort Analysis", "description": "Find all fictions published within ±15 days of a reference date or fiction, and compare their performance. Returns peak ranks, follower counts, and aggregate stats for the cohort.", "tags": ["cohorts", "publishing", "comparison", "debut", "competition"], "examples": [ "What other fictions debuted around the same time as fiction 138753?", "How did fictions published in March 2024 perform?", "Find my fiction's competition cohort." ] }, { "id": "churn-analysis", "name": "Market Churn Rate Analysis", "description": "Calculate the Rising Stars list churn rate (percentage of new entries per cycle) over any time window. Returns daily breakdown with entry and exit counts.", "tags": ["churn", "analytics", "market", "volatility", "trends"], "examples": [ "What is the 30-day average churn rate?", "How volatile has the Rising Stars list been this month?", "Show me the daily churn rate for the past week." ] }, { "id": "fiction-stats-export", "name": "Fiction Statistics CSV Export", "description": "Download complete hourly statistics for a fiction as a CSV file including timestamp, views, followers, favorites, and Rising Stars position over its entire tracked history.", "tags": ["export", "csv", "stats", "download", "views", "followers"], "examples": [ "Download the stats for fiction 138753.", "Export the hourly follower data for this fiction." ] }, { "id": "hall-of-fame", "name": "Hall of Fame", "description": "View quarterly top 50 lists of the most notable Rising Stars fictions. Legends are ranked by duration on the list; Titans by peak follower count.", "tags": ["hall-of-fame", "top-fictions", "quarterly", "legends", "titans"], "examples": [ "Who were the top Rising Stars fictions in Q1 2025?", "Which fiction stayed on the Rising Stars list the longest?", "Show me the Titans for Q3 2024." ] }, { "id": "hall-of-fame", "name": "Hall of Fame", "description": "View quarterly top 50 lists. Legends ranked by duration on Rising Stars; Titans by peak follower count. Response includes all available quarterly windows.", "tags": ["hall-of-fame", "quarterly", "rankings", "legends", "titans", "royal-road"], "examples": [ "Who were the top Rising Stars fictions in Q1 2025?", "Which fiction stayed on Rising Stars the longest?", "Show me the Titans for Q3 2024." ] }, { "id": "cohort-analysis", "name": "Publishing Cohort Analysis", "description": "Find all fictions published within ±15 days of a reference date or fiction and compare their performance. Pass fictionId to use a fiction's publish date, or date for a specific YYYY-MM-DD.", "tags": ["cohorts", "publishing", "debut", "competition", "comparison"], "examples": [ "What other fictions debuted around the same time as fiction 138753?", "How did fictions published in March 2024 perform on Rising Stars?", "Find the competition cohort for my fiction." ] }, { "id": "system-health", "name": "System Health", "description": "Check the operational status of the platform including database connectivity, latest snapshot age, total snapshot count, and memory usage.", "tags": ["health", "status", "monitoring", "uptime"], "examples": [ "Is the Rising Stars tracker online?", "When was the last snapshot captured?", "Check system health." ] } ] }