Mango Agent Docs

Mango Agent is an autonomous AI content system for Instagram. It watches what goes viral in your niche, generates original on-brand posts — images, carousels, and Reels — and publishes them automatically on a schedule you control. You set it up once and it runs in the background.

1. 1
   Create your account at mymangoagent.com/register
2. 2
   Create your first Project and fill in your brand style and content rules
3. 3
   Add competitor Instagram accounts to track
4. 4
   Connect your Instagram via Zernio (see Publishing section)
5. 5
   Create an Agent and set your posting schedule
6. 6
   Hit Run Now to generate your first post manually and verify everything looks right
7. 7
   Activate the agent and let it run automatically

A Project is the core container for everything — your brand style, content rules, tracked competitors, and publishing settings. You can have multiple projects for different accounts or niches.

To create one: click + New on the Projects page, give it a name and a short description of your niche, then configure the settings tabs (AI models, Image style, Content rules, Reels, Integrations).

• Analysis model — the AI used to analyze competitors and generate post ideas. Claude Sonnet 4.5 is recommended.
• Image model — the AI used to generate images. Nano Banana 2 (Gemini 3.1 Flash Image) is recommended for character-based projects. Imagen 4 for photographic style.
• Image text quality check — after generating an image, AI verifies the text is rendered correctly and regenerates if there are issues. Adds 30–60 seconds per image. Recommended on.
• AI text compositing — generates the image without text first, then adds text in a second AI pass. Produces cleaner, more readable text overlays. Recommended on.
• Post language — all captions, on-image text, and generated ideas will be in this language.
• Text on image — whether to always include text, never include it, or let the AI decide per post.

This is the most important section for output quality. The more detail you provide here, the better and more consistent your images will be.

• Prompt engineer look — sets the overall visual language. Choose 2D Cartoon for illustrated characters, Photographic for realistic lifestyle content, Anime for stylized illustration, Cinematic for dramatic dark visuals.
• Aspect ratio — use 1:1 for feed posts, 4:5 for portrait feed, 9:16 for Reels.
• Reference description — describe the overall look and feel of your brand in 2–3 sentences. This is shown to the image AI on every generation.
• Character description— if your account uses a consistent character, describe them in detail. Example: "Young professional in their mid-20s, friendly and approachable look, casual everyday clothing. Expressive face that matches the emotional tone of each post."
• Character reference images — upload 1–3 photos of your character or visual style. These are passed directly to the image model to lock in consistency. This is the single biggest factor for consistent output.
• Primary / secondary color— your brand accent colors described as plain English (e.g. "warm orange") or hex codes. The AI will use these throughout every image.
• Art style— describe the exact illustration style you want. Example: "High quality illustration style, clean lines and soft shading, expressive characters and detailed scenes."
• Additional composition notes— any layout rules that apply to every image. Example: "Character always on the right, leave space on the left for text."
• Always avoid— things that should never appear. Example: "No dark backgrounds, no male characters, no photorealistic style."

Content rules guide the AI when generating post ideas, captions, and analysis insights.

• Niche — one sharp sentence describing your content focus. Used heavily in every analysis and idea generation call.
• Target audience — who the content is written for. Be specific about age, interests, and goals.
• Tone and voice— how captions should sound. Example: "Direct, confident, and conversational. Speaks to the audience like a trusted expert, not a brand."
• Content pillars — the topics your posts cover. Add 5–10 specific topics separated by commas. Example: morning routines, productivity tips, mindset, nutrition basics, workout advice.
• Preferred post formats — the formats you want the AI to use. Example: tip list, myth vs fact, before after, carousel routine.
• Forbidden content— topics or angles to never generate. Be explicit. Example: "Never make income guarantees, never use fear-based or shame-based messaging, never mention competitor brands by name."
• Content goal— what the content should accomplish. Example: "Build authority in the niche and grow a loyal audience who saves and shares posts because they find real value in them."

Reels generate short AI videos (8–15 seconds) in 9:16 portrait format for Instagram Reels.

• Enable Reels — must be toggled on for the agent to generate video posts.
• Video model — choose your video generation model. Kling 3.0 Omni is recommended for character-consistent videos. Seedance 2.0 Fast is the most cost-efficient for 15-second clips.
• Reel audio — choose between Ambient (natural background sounds), Voiceover (AI-generated spoken narration), or Music (background instrumental).
• Voiceover provider — OpenAI TTS or ElevenLabs. ElevenLabs produces significantly more natural-sounding and multilingual voices.
• Voice description— describe the voice character in plain language. Example: "Confident male voice, upbeat and motivating, like a coach speaking directly to the viewer."
• Voiceover instructions— tell the AI how to write the spoken script. Include any intro phrase, outro phrase, and pacing notes. Example: "Open with a short hook — end with a call to action like 'Check the description for more.' Keep the pace steady and clear."

Mango Agent publishes to Instagram through Zernio — a simple, reliable publishing connector. Here's how to set it up:

1. 1
   Create a Zernio account — go to zernio.com and sign up for a free account.
2. 2
   Log in to Zernio — once inside, navigate to your dashboard.
3. 3
   Connect your Instagram — in Zernio, go to Accounts → Add account → select Instagram and follow the authorization flow. Your Instagram account must be a Business or Creator account connected to a Facebook Page.
4. 4
   Copy your API key — in Zernio, go to Settings → API Keys → copy your key.
5. 5
   Add the key in Mango Agent — in your Project settings → Integrations tab → paste your Zernio API key and click Connect.
6. 6
   You're connected — Mango Agent will now publish directly to your Instagram when an agent run completes.

Agents are the automation engine. Each agent is linked to one project and runs on a schedule you define.

To create one: go to the Agents section in the sidebar → click + New Agent → select the project it belongs to → give it a name → set your schedule.

Each schedule slot has three settings:

• Day — which day of the week to post
• Time — what time to post (UTC, 15-minute intervals)
• Post type — Image, Carousel, or Reel

You can add multiple slots per agent. Example: Monday 09:00 Carousel, Wednesday 18:00 Image, Friday 12:00 Reel.

You don't have to wait for the schedule. Click Run Now on any agent to immediately trigger a generation and post. A dropdown lets you choose whether to generate an Image, Carousel, or Reel regardless of what the schedule is set to.

Manual runs count toward your daily and monthly post limits.

Each time an agent fires (scheduled or manual), it goes through these phases shown in the live log:

• Analyze — scrapes tracked competitor accounts and runs AI analysis
• Generate idea — picks the best post angle based on analysis and your content rules
• Generate image / video — builds and executes the image or video generation prompt
• Text compositing — adds text overlays if enabled
• Publish — sends the post to Instagram via your connected integration

You can watch the live log in real time on the Agent detail page. Each phase shows detailed logs so you can see exactly what the AI decided and why.

The image quality is directly determined by how well you fill in the Image Style settings. The highest-impact things:

• Upload character reference images — this single change has the biggest impact on consistency
• Be specific in your character description — vague = generic results. Describe hair, skin tone, clothing, expression style in detail
• Use the right prompt engineer look — 2D Cartoon for illustrated characters, not Photographic
• Fill in Additional composition notes — tell it exactly where the character should be, what text zone to leave empty
• Fill in Always avoid — prevents recurring unwanted elements

• Fill in all Content rules fields — niche, audience, tone, pillars, forbidden content
• The more specific your tone description, the more consistent the caption voice
• Add 8–10 content pillars — more variety means the AI never runs out of fresh angles
• Use forbidden content to block anything off-brand

• Upload 2–3 reference images showing the character from different angles or in different scenes
• Keep the character description under 150 words — too long dilutes the signal
• Use Nano Banana 2 or Kling 3.0 Omni for video — both have strong character consistency
• For video, Kling 3.0 Omni specifically accepts character reference images as elements which locks identity across the entire video