Give Gemini your social media
Gemini reads the web; ViralHunt measures it. Connect the two and your agent finds what is rising in your niche on 13 sources, explains why it works and turns it into a draft on your brand template. Works with Gemini CLI and with Antigravity CLI, which replaced it for most Google AI subscribers in June 2026.
Free forever · no card · 24 content queries a day on the free keyWhat Gemini can do with ViralHunt
Gemini calls ViralHunt's MCP tools for live numbers it cannot get by searching: growth in the last day, the best hour per weekday, the hashtags that carried a post. With the skill it follows our method and stops at a draft for your review.
Find
Trending posts on 13 sources, ranked by growth in the last day, the best time to post per weekday and the hashtags, sounds and communities that carry a niche.
Create
Drafts on your own brand templates, one copy per network, translated into a second brand's language when you run one.
Publish, with you in charge
Scheduling to 11 networks on a paid plan. Agents leave drafts; nothing goes out until a person approves.
Set it up
Which one do you have? Google AI Pro and Ultra subscribers and free Code Assist users run Antigravity CLI since June 18, 2026; Gemini CLI stays for Code Assist Standard and Enterprise and for paid Gemini API keys. Steps for both.
Create a free account and your API key
The Free plan never expires and never asks for a card. In the app: Account, then API Access, then New token. It starts with vhk_. Keep it out of chats; it goes in a config file or an environment variable.
Gemini CLI: add the server
One command. Use --scope user so it works in every folder (the default is the current project).
Local server (recommended)
gemini mcp add --scope user -e VIRALHUNT_API_KEY=vhk_your_key viralhunt npx -y viralhunt-mcpOr the remote server, then sign in inside Gemini with /mcp auth viralhunt
gemini mcp add --scope user --transport http viralhunt https://viralhunt.io/mcpThe same in ~/.gemini/settings.json
{
"mcpServers": {
"viralhunt": {
"command": "npx",
"args": ["-y", "viralhunt-mcp"],
"env": { "VIRALHUNT_API_KEY": "vhk_your_key" }
}
}
}Antigravity CLI: add the server
Antigravity has no add command: edit the file below, then type /mcp to open the MCP Manager and reload. A remote server signs in by itself the first time.
~/.gemini/config/mcp_config.json
{
"mcpServers": {
"viralhunt": {
"command": "npx",
"args": ["-y", "viralhunt-mcp"],
"env": { "VIRALHUNT_API_KEY": "vhk_your_key" }
}
}
}Or the remote server
{
"mcpServers": {
"viralhunt": { "serverUrl": "https://viralhunt.io/mcp" }
}
}Install the skill and check it
Gemini CLI installs Agent Skills from a git repository; Antigravity keeps them too. Then /mcp should show viralhunt as connected with its tools.
Gemini CLI
gemini skills install https://github.com/viralhunt-io/viralhunt-skill --path skills/viralhunt --scope user --consentOr by hand (both)
mkdir -p ~/.agents/skills/viralhunt
curl -fsSL https://raw.githubusercontent.com/viralhunt-io/viralhunt-skill/main/skills/viralhunt/SKILL.md \
-o ~/.agents/skills/viralhunt/SKILL.mdChecked against Gemini's own documentation: Gemini CLI MCP · Gemini CLI skills · Antigravity MCP · Google's announcement.
Everything to copy, in one place
The same four pieces work in every agent. Gemini needs the ones marked in the steps above; the rest are here when you move to another tool.
🔗Remote MCP server
Nothing to install. Sign in with your ViralHunt account when the agent asks; it works for every agent that accepts a remote MCP address.
https://viralhunt.io/mcp📦Local MCP server (npm)
For agents that run local servers. Node 18 or newer; your key goes in an environment variable, never in a chat.
npx -y viralhunt-mcp # with VIRALHUNT_API_KEY=vhk_your_key📚The skill (the method)
One text file that teaches any agent how to work ViralHunt: what to ask first, how to verify a story, which template fits which post, and to leave drafts instead of publishing.
Open SKILL.md → · GitHub💬A first prompt
Paste it after connecting. Change the niche; the agent does the rest and stops at the draft.
Use ViralHunt. My niche is fitness for busy parents.
1. Show me what is rising on TikTok and Instagram in the last 24 hours, with the numbers.
2. Pick the three posts most likely to work for my brand and say why.
3. Turn the best one into a draft on my brand template, one copy per network, and leave it for my review.Go further: run Gemini and your other AIs in one office
OfficeMatrix is a free, open-source office for your AI CLIs. It runs on your computer, on the subscriptions you already pay (Claude Code, Codex, Gemini, Grok, Kimi), and connects to ViralHunt with a six-letter code: no port, no tunnel, no key to copy. Then your team asks from inside ViralHunt (the composer, the board, a translation for your second brand) and the office answers, with the model you pick for each job. A person still saves every result.
- Install it. Node.js 18 and git are the only requirements.
git clone https://github.com/rodvan/OfficeMatrix.git cd OfficeMatrix sh instalar.sh # Windows: .\instalar.ps1 node server.js - Start your CLIs. Open
http://127.0.0.1:4321. Getting started lists the CLIs it found and gives the install and sign-in command for each one missing. One is enough; more means more models to choose from.claudecodexgeminigrokkimi - Connect ViralHunt. In the office press Connect ViralHunt. It shows a code and opens ViralHunt; you press Approve. The office now receives tasks the moment someone asks (a long-poll connection, like a chat bot).
- Ask from ViralHunt. In the composer, the design editor or a card, pick the office as the agent and say what you want: "rewrite this for LinkedIn", "make the picture in English for our second brand".
What the free key does
Enough to see it work on your niche today. A paid plan, priced per brand, adds the live numbers, drafts on your templates and publishing.
| Free | Creator, Studio, Agency | |
|---|---|---|
| Content queries (trends, hashtags, sounds, best time, communities) | 24 a day | By plan, hundreds an hour |
| Freshness of trending posts | 72 hours ago and older | As it breaks |
| Engagement numbers and growth | Withheld | Included |
| Drafts, review, brand templates, publishing to 11 networks | 10 drafts a month to try templates | Yes |
Questions
Gemini CLI or Antigravity CLI?
Since June 18, 2026 Google AI Pro and Ultra subscribers and free Code Assist users run Antigravity CLI. Gemini CLI remains for Code Assist Standard and Enterprise licences and paid Gemini API keys. ViralHunt works in both.
Why does Gemini need ViralHunt if it can search the web?
Search shows what was published. ViralHunt measures what is growing: engagement read every few hours on 13 sources, so the agent can say this post gained most in the last day, not just that it exists.
The server shows as disconnected
For a local server, trust the folder (gemini trust) and check Node 18 or newer. For the remote server, run /mcp auth viralhunt; sign-in opens a browser, so it does not work over SSH.
Can Gemini publish without asking me?
No. Agents leave drafts and a person approves before anything goes out.
What does the free key do?
24 content queries a day with posts 72 hours old and numbers withheld. A paid plan adds live data, drafts on your templates and publishing to 11 networks.
Also works with
Five minutes to the first answer.
Create the account, connect Gemini, ask what is rising in your niche.
Create free account