Skill for using ViralHunt.io
Commits on main
Two pictures go out only when the post is marked as a carousel (Rodrigo: publishing two pictures nobody asked for is absurd; the rule existed only on the API and on template posts). scheduled_posts.carousel (migration api/scheduled-posts-carousel-schema.sql) stores the author's mark; vh_post_pictures_check / vh_post_pictures_check_all is THE rule (a design post: one picture whatever the mark; else more than one picture without the mark is refused naming the files, on the post's media and on every per-account list), run in vh_post_fanout for every send (the mark travels in vh_fanout_carousel, set by vh_post_send, both creates, the three retries and the sync), in vh_draft_insert and vh_draft_submit for a post into Review, on the web save_draft of a post in Review, and on the v1 create/update (422 multiple_pictures; carousel: false on a post holding several pictures is refused). A working draft may hold several pictures until it is submitted. vh_media_dedupe makes the same URL count once. Composer: the Carousel tick appears under the thumbnails from the second picture and publish/submit is refused without it; Drafts page: a row naming the pictures with the tick; the mark is in the content hash and on every API row. Skill 1.6.37, docs, changelog EN+ES, CLAUDE.md, tests/one-picture-rule.php; the release script treats a registry already at the MCP version as done Rodrigo committed 27 days ago
e2f677a The brand's voice: projects.voice (migration api/projects-voice-schema.sql), edited in the project modal on Projects (Voice and rules for your agent, 12,000 chars), returned by GET /v1/schedule.php?action=targets as projects[].voice; skill 1.6.35 (5a: read the voice first and follow it over the general rules, offer to draft one when empty, never write it in; complete means every network's short copy in overrides in the same create, X 280, Bluesky 300, Threads 500, a real summary never a cut), MCP 1.1.26, docs, a guide prompt that drafts the voice from the brand's best posts, the Cerebro Digital playbook in docs/brand-voice-cerebro-digital.md (Rodrigo: train the agent on hooks, writing and copywriting; summaries for Bluesky, Threads and X without asking each time) Rodrigo committed 1 month ago
e5b7569 Hipatia's product notes of 2026-10-20: the Idempotency-Key is the same on every automatic resend (it carried -rN per attempt, a new key each time; only a person's forced retry gets a new one), a translation carries a source account's override over as the target network's copy, every trending row carries metrics {likes, comments, shares, views, saves, engagement} under one vocabulary (docs row), and the skill (1.6.33) teaches who may do what by role and tick, that a timeout or gateway 502 is maybe live, and to read metrics Rodrigo committed 1 month ago
a81deeb The link to a post opens it ready to edit, from any project: the composer's scOpenFromUrl handles ?edit=N, ?post=N and the old ?view=drafts&highlight=N (fetches the post, switches the active project when it lives in another one, loads a draft or a post in review into the composer, shows the detail of anything sent; scEditDraft used to return in silence when the post was not in the active project's queue, which is why Rodrigo saw nothing on 1164). The API's url points at edit for a draft or a post in review and design_url at the template editor on its design. The working agreement (every post to Drafts complete, never to Review unless asked, one five-line hand-over with the url, the rest in author_notes, one project at a time on the Drafts page, media_removed is retention, an API surprise is one message with call and answer) is written the same way in SKILL.md 5a (1.6.32), the MCP tool text and README (1.1.25), the API docs, the create answer's message, the agent guide (a prompt to paste), the API Access template, /claude and the changelog Rodrigo committed 1 month ago
fa6428d A timed-out create is not a failure (post 1136: Facebook answered after the 30 s cut, three retries, four copies): the create waits 120 s with an idempotency key, a timeout leaves timed_out with no automatic retry, the sync looks the post up on PostProxy and adopts it, retry needs force, cancel {id, account_id} stops one network, GET list and POST delete exist on the API, action is read from the JSON body (update used to create post 1142), Bluesky followups are unsupported instead of retried nine times, a releaser may approve. Skill 1.6.30, MCP 1.1.24, docs, changelog, CLAUDE.md Rodrigo committed 1 month ago
020a11a Hipatia's third report: cards take the assignee by id, name or email under any of the names agents use, refuse unknown fields with 422, and gain get, list, assign and archive (+ GET); a send survives a client that gives up, writes every PostProxy id the moment it arrives, the API create inserts the row before fanning out, and the sync names an interrupted send instead of calling it failed-retry (post 1097 was published and resent); drafts rows carry publishes[] (the exact text each account sends) so the reviewer judges what goes out; v1 retry {id, account_id}. Skill 1.6.29, MCP 1.1.23, docs, CLAUDE.md Rodrigo committed 1 month ago
19af88c Brand watch for agents (BrandiZone): GET/POST /v1/brand.php (status with the sweep state per network, keywords read and replace, hot = the discussions heating up right now with their links, alerts with read marks, a signed webhook per brand); the alerts cron POSTs every run's new alerts to the brand's webhook (X-VH-Signature sha256 HMAC, 8 s, no retry); the Projects keywords box takes the webhook URL and shows the secret; migration api/brand-webhooks-schema.sql. Skill 1.6.27 (section 8d, onboarding step), MCP 1.1.21 (five viralhunt_brand_* tools), docs, guide prompt, changelog, CLAUDE.md Rodrigo committed 1 month ago
0735e0f Bold, italics, underline and colour inside the texts of a template: four inline marks (**bold**, *italic*, __underline__, {c:#hex}…{/c}, {c:accent}…{/c}) as plain text in the variable, converted at render time by the runtime every template's html now carries (inside the shared runtime v2, whose highlight is painted on the DOM so a bold word stays bold in a coloured phrase; a standalone rich runtime with a MutationObserver for templates that keep their own script); appended at save, in vh_draft_render, card design, the gallery, v1 templates (?runtime=1 returns inline_marks and rich_script) and the editor preview. Editor: a floating formatting bar on any selected text in the panel's fields (B, I, U, accent, the palette's swatches, any colour, eraser), chips without marks, a formatted block is edited in the panel. Skill 1.6.26, docs, changelog, CLAUDE.md Rodrigo committed 1 month ago
6fee19f Hipatia's second report, answered in the API: a too-long text answers 422 text_too_long (it was a 500 with an empty body); stage: draft|review on create; assigned_to on create and update (the post's board card is assigned, the member notified), drafts&assigned_to=N, rows and get carry the assignee; get answers the full drafts-row shape (overrides, design and render, thread, review, card_id, kind, lang) so a reviewer sees what each network will publish; update answers the stage read back after the edit; upload tells "nothing parsed" (400 upload_not_parsed) apart from "too large"; cancel is the delete and an unknown action lists the actions. Templates: the platform's shared runtime (data-highlight colours the words, data-fit shrinks the text, data-vh-ready) is appended to a template that uses the attributes and lost its script to the wall (POST and cron/sanitize-templates), its hash trusted and stashed around the DOM pass (libxml mangled the /</g inside it and the second pass stripped it); GET ?runtime=1 and ?slug=…&preview=1 (a complete page with the example or given values). translate: no dashes, and a short copy becomes the override of every target network whose limit the translated body passes. ops rss_signals. Skill 1.6.24, MCP 1.1.19, docs, changelog, CLAUDE.md Rodrigo committed 1 month ago
5cbb502 API usage by plan and client: ops api_usage (requests, organizations, users, IPs by plan, per day, by endpoint, by client, top free organizations, quota hits, tokens minted); api_request_log.client from the X-VH-Client header (the MCP sends viralhunt-mcp/<version>, 1.1.14) else the User-Agent, migration request-log-client-schema.sql; skill 1.6.17 says once, when numbers are withheld, that Creator ($29) shows everything live Rodrigo committed 1 month ago
c464639