An assistant does not see RandomTranslator's pages: it calls tools. Each tool has one job, takes a few plain inputs and answers twice, as typed data (structuredContent) and as a short markdown text that many apps show directly.
Rules every tool follows#
- Read only. Every tool is marked
readOnlyHint: true,destructiveHint: false,idempotentHint: true,openWorldHint: false. - Nothing is spent. No tool translates, re-translates, requests or refreshes a novel, uses Google Translate, reads aloud, or calls an AI model.
- No chapter text appears in any answer.
- Naming a novel.
novel_idtakes the number (1234),"#1234", or a randomtranslator.com novel or chapter URL. Other sites' URLs are refused. - Forgiving inputs. Unknown inputs are ignored, and a
limitordaysabove its maximum is lowered rather than refused. - English only. Answers are in English, with the original Chinese titles and names where they exist.
- Errors are one sentence the assistant can act on (an unknown novel, a bad input, a missing permission, a limit), never a stack trace.
- Links. Every novel comes with its RandomTranslator URL, and the assistant is told to show it. Dates are UTC, in ISO 8601.
- Permissions. The assistant sees only the tools its permissions allow (see Get a key).
A novel line in the text answer reads:
[1234] **A Novel Title** (原名) · Author · Completed · 1,200 ch · https://randomtranslator.com/novel/1234/a-novel-title
search_novels#
Find novels on RandomTranslator by English or Chinese title, or by author, best match first. A randomtranslator.com novel URL returns that novel.
| Permission | read:catalog |
| Inputs | query (required, up to 100 characters), limit 1 to 25 (default 10) |
| Answers | query, results: novel_id, title, original_title, author, status, genre, chapter_count, last_chapter_added_at, rt_url |
Ask: "Is Lord of the Mysteries on RandomTranslator?" · "Find novels by 辰东."
get_novel#
One novel's page facts.
| Permission | read:catalog |
| Inputs | novel_id |
| Answers | novel_id, title, original_title, author, original_author, synopsis (English), synopsis_is_ai, status, genre, tags (up to 12), fandoms, chapter_count, word_count, is_preview, last_chapter_added_at, cover_url, rt_url, recaps_url, glossary_url, daosearch_url; with read:library also current_chapter and continue_url (your place, as where_am_i gives it) |
daosearch_url is a link to the novel on DaoSearch, where its Chinese-side rankings and reviews are; it is the only DaoSearch data, and null when we hold no link.
Ask: "Tell me about Martial Peak. Is it finished? How long is it?"
browse_novels#
Browse the catalogue by genre, fandom, status, and fan fiction or original, sorted as the Browse page sorts. Use search_novels for a title or author.
| Permission | read:catalog |
| Inputs | genre (one of the site's genres; "BL", "sci fi" and the like are understood), fandom (a franchise name, like Naruto), status (completed, ongoing, hiatus, discontinued), fanfic (all, only, exclude), sort (updated default, popular, rating, newest, chapters, views), limit 1 to 25 (default 10) |
| Answers | the filters as applied, results (as search_novels), browse_url |
Ask: "Completed xianxia, best rated first." · "Any Naruto fan fiction that is still ongoing?"
get_popular#
The most-read novels today, this week, this month or of all time, by unique readers: the site's own ranks.
| Permission | read:catalog |
| Inputs | range (daily, weekly default, monthly, all_time), fanfic (all, only, exclude), limit 1 to 25 (default 10) |
| Answers | range, fanfic, items: rank, readers, novel (a novel as in search_novels); popular_url |
Ask: "What's popular this week in fan fiction?"
get_similar_novels#
Novels like a given one: the novel page's "Readers also enjoyed" list, from what its readers also read, topped up with popular novels of the same fandom or genre.
| Permission | read:catalog |
| Inputs | novel_id, limit 1 to 10 (default 10) |
| Answers | novel_id, title, original_title, rt_url, results (as search_novels) |
Ask: "Anything like Martial Peak?"
get_novel_reviews#
A novel's reader rating and its written reviews, most liked first, with spoilers hidden. Reviewers appear by public display name.
| Permission | read:catalog |
| Inputs | novel_id, limit 1 to 10 (default 5) |
| Answers | novel_id, title, original_title, rating_count, recommended, mixed, not_recommended, score_percent, rating_score, review_count, reviews: reviewer, rating, text, likes, replies, read_to_chapter, updated_at; reviews_url |
Ask: "What do readers say about this novel?"
get_chapter_list#
A page of a novel's chapter index: number, title, word count, whether an English translation is stored, and the reading link on the site. Never chapter text.
| Permission | read:catalog |
| Inputs | novel_id, from_chapter (also from; default the first), limit 1 to 200 (default 50) |
| Answers | novel_id, title, original_title, chapter_count, current_chapter (your place), chapters: number, title, original_title, translated, word_count, url; next_from for the next page |
Ask: "Which chapters of this novel are translated so far?"
get_my_library#
Your library, most recently read first.
| Permission | read:library |
| Inputs | shelf: reading, plan_to_read, paused, completed, dropped or all ("Plan to read" and "on hold" are understood); limit 1 to 50 (default 20) |
| Answers | shelf, total, shelf_counts, items: novel_id, title, original_title, shelf, current_chapter, chapter_count, unread_chapters, last_read_at, last_chapter_added_at, rt_url, continue_url |
Ask: "What's on my plan-to-read shelf?" · "What should I read next from my library? Something finished."
my_updates#
Novels in your library that got new chapters recently, newest first.
| Permission | read:library |
| Inputs | days 1 to 30 (default 7), limit 1 to 50 (default 20) |
| Answers | days, since, items: novel_id, title, shelf, last_chapter_added_at, chapter_count, current_chapter, unread_chapters, rt_url, continue_url (your next unread chapter) |
Ask: "Which of my novels updated this week?"
my_notifications#
Your notifications, newest first: chapter updates, new novels for your saved searches, your requests, glossary and report outcomes, replies and mentions, level-ups and site news. It never marks anything read.
| Permission | read:library |
| Inputs | category (chapters, new_novels, requests, contributions, social, progression, site, general; without it, all), unread_only (default false), limit 1 to 30 (default 10) |
| Answers | category, unread_only, unread_count, items: category, title, message, read, created_at, url; notifications_url |
Ask: "Any notifications I should look at?"
where_am_i#
Your place in one novel.
| Permission | read:library |
| Inputs | novel_id |
| Answers | novel_id, title, started, in_library, shelf, current_chapter, current_chapter_title, chapter_count, percent, last_read_at, continue_url (your chapter, or chapter 1), rt_url |
Ask: "Where was I in Martial Peak?"
recap_to_here#
The story so far, without spoilers: the site's written volume and arc recaps that end at or before your place, oldest first. The newest is whole; older ones are cut to their first paragraph when the answer grows past about 24,000 characters. It never writes a new recap.
| Permission | read:recaps |
| Inputs | novel_id, up_to_sequence (optional: a chapter number; by default your current chapter, and without either the tool asks for one) |
| Answers | novel_id, title, up_to_sequence, stop_source (reader or argument), blocks: level (volume or arc), index, start_chapter, end_chapter, title, text, abridged; covered_through, uncovered_from, recaps_url, summaries_url |
Ask: "Recap Martial Peak up to where I am." · "What happened before chapter 800?"
summarize_chapters#
The site's stored summary of each chapter in a range, up to 31 chapters a call. It stops at your current chapter unless you ask for spoilers, and never writes a summary.
| Permission | read:recaps |
| Inputs | novel_id, from_chapter (also from, required), to_chapter (also to; default 9 after from_chapter), allow_spoilers (default false) |
| Answers | novel_id, title, original_title, from_chapter, to_chapter, requested_to, reader_chapter, stopped_at_place, summaries: number, title, summary; missing (chapters with no summary yet), summaries_url |
Ask: "Summarise chapters 300 to 320 for me."
find_in_novel#
The chapters whose stored summary or title mentions a name or phrase, earliest or latest first, with the matching lines. A plain text match on the English summaries, up to your current chapter unless you ask for spoilers. Never chapter text.
| Permission | read:recaps |
| Inputs | novel_id, query (2 to 100 characters), order (first default, latest), limit 1 to 10 (default 5), allow_spoilers (default false) |
| Answers | novel_id, title, original_title, query, order, searched_to, hits: number, title, lines, url; summaries_url |
Ask: "In which chapter did Su Yan first show up?"
glossary_lookup#
How a novel's names and terms are translated: its own entries plus the shared terms that apply to it, as the translator uses them. Hidden entries never show.
| Permission | read:glossary |
| Inputs | novel_id, query (optional: part of an English or Chinese name, up to 100 characters; without it, the most mentioned terms), limit 1 to 100 (default 30) |
| Answers | novel_id, title, query, total_matched, terms: original, translated, kind, gender, general (a shared term), mentions, my_translation (your personal translation, if you set one); glossary_url |
Ask: "Who is 萧炎 in this novel?" · "What is the sect called in English?"
my_limits#
Your limits today, so the assistant can say what is left: the daily chapter allowance (shared by reading on the site, offline downloads and RandomTranslator's own apps), read-aloud characters and original-text views, each with its ceiling. The same numbers as GET /api/v1/limits/me.
| Permission | read:library |
| Inputs | none |
| Answers | day_resets_at, and chapters, tts_characters, original_views, each used, limit, remaining (null limit: no ceiling; null used: could not be read just now) |
Ask: "How many chapters do I have left today?"
What the assistant is told#
When it connects, the assistant is told that RandomTranslator hosts English translations of Chinese web novels; to start with search_novels or get_my_library / my_updates, then use where_am_i, recap_to_here and glossary_lookup; to always link the RandomTranslator page; that reading happens on the site; and that get_novel links DaoSearch, which has its own connector, for Chinese-side rankings and reviews.