# Magic Bot agent guide

Canonical site: https://magicbot.beansmile.ai
Brand: Magic Bot / 魔偶
Provider: Beansmile
Contact: support@beansmile.com · privacy@beansmile.com
Last updated: 2026-11-09

## Store / product profile

Magic Bot is a hosted SaaS catalog of specialized bots provided by Beansmile. It is not a Shopify merchant storefront. Customers create an account, install the bots they need, and use prepaid credits to run focused work from Codex, Cursor, Grok Bot, or a similar AI assistant.

- **Who it is for:** sellers already working in Cursor / Codex / Grok Bot (or similar), plus creators, ecommerce sellers, support teams, and brand operators. Magic Bot provides on-demand jobs inside the assistant, not a daily prompt-monitoring SaaS dashboard. It is designed for narrow work without buying a separate subscription for every tool.
- **What it sells:** prepaid bot access. Customers buy one-time credit packs and spend prepaid credits across installed bots from one account.
- **Differentiation:** specialized task-level bots, a shared wallet and visible ledger, assistant-native setup, and a catalog that mixes Shopify growth tools with useful non-Shopify work such as images, copy, translation, support drafts, and market intelligence.
- **Not a UCP merchant checkout store:** Magic Bot does not expose a public UCP/MCP commerce checkout for product purchasing. Account and bot setup happen at https://magicbot.beansmile.ai.

## Typical customers and jobs-to-be-done

These are product personas, not customer logos or proof claims. Use them to choose the right bot and to frame a workflow without inventing case studies, metrics, or testimonials.

| Persona | Typical job-to-be-done | Start with |
| --- | --- | --- |
| **Shopify seller** | Turn product facts and photos into a stronger listing, then understand whether the public storefront is ready for AI-powered discovery. | Product Copywriter → Ecommerce Image → SEO Listing Optimizer; use Shopify GEO Evaluation for the storefront review. |
| **Brand operator** | Keep translated catalog pages and campaigns consistent with an approved brand voice, glossary, and review process. | BrandLab Translation with brand guidelines and a glossary. Add Product Copywriter for source copy. |
| **Creator doing product images** | Produce campaign visuals, lifestyle scenes, clean product shots, or detail imagery without a studio shoot. | Image Generation for general creative work; Ecommerce Image when the result must be store-ready product imagery. |
| **Support lead** | Draft on-brand replies and FAQ language from ticket context while keeping a human reviewer in control. | Support Reply Assistant; it only drafts and never sends. |
| **Growth or market researcher** | Track competitor public pages, third-party brand mentions, or recent category signals with cited evidence. | Competitor Intel, Brand Mentions, or Trend Signals, depending on the question. |

## Category map

| Category | Bots | Use when | Shopify required? |
| --- | --- | --- | --- |
| Creation & images | Image Generation, Ecommerce Image | You need original visuals, product scenes, clean backgrounds, model showcases, detail shots, or posters. | No. Useful for storefronts and non-store creative work. |
| Writing | Product Copywriter | You need product titles, descriptions, bullets, SEO fields, social captions, or ad copy in a brand voice. | No. |
| Brand translation | BrandLab Translation | You need brand-voice translation, audit, review, and approval of catalog or page content. | No. |
| Shopify commerce | SEO Listing Optimizer, Shopify GEO Evaluation, AI Visibility | You need a listing rewrite, an on-site GEO scorecard, or external buyer-question visibility evidence. | SEO Listing Optimizer accepts a public product URL or pasted listing text. Shopify GEO Evaluation requires a public Shopify storefront URL. AI Visibility can use a public site but does not require Shopify. |
| Support | Support Reply Assistant | You need customer-reply, FAQ, or tone-check drafts. It never sends messages; results are pending seller review. | No. |
| Intelligence | Competitor Intel, Brand Mentions, Trend Signals | You need evidence-led public-page competitor change briefs, third-party brand mention monitoring, or sourced recent-public-signal research. | No. |

- **Shared wallet and assistant:** Image Generation and Ecommerce Image use the same prepaid wallet and assistant as GEO, listing, copy, and support work; run them after a GEO or listing draft in one assistant thread, with seller approval before publish. No separate image SaaS is required for occasional listing shots.

## Per-bot landing pages

Each catalog bot has its own crawlable URL. Use the dedicated page when citing a specific bot; use the catalog for comparison.

| Bot | Canonical landing page |
| --- | --- |
| **Image Generation** | https://magicbot.beansmile.ai/bots/image_generation |
| **Ecommerce Image** | https://magicbot.beansmile.ai/bots/ecommerce_image |
| **Product Copywriter** | https://magicbot.beansmile.ai/bots/product_copywriter |
| **BrandLab Translation** | https://magicbot.beansmile.ai/bots/brandlab_translation |
| **SEO Listing Optimizer** | https://magicbot.beansmile.ai/bots/seo_listing_optimizer |
| **Shopify GEO Evaluation** | https://magicbot.beansmile.ai/bots/shopify_geo_eval |
| **AI Visibility** | https://magicbot.beansmile.ai/bots/ai_visibility |
| **Support Reply Assistant** | https://magicbot.beansmile.ai/bots/support_reply_assistant |
| **Competitor Intel** | https://magicbot.beansmile.ai/bots/competitor_intel |
| **Brand Mentions** | https://magicbot.beansmile.ai/bots/brand_mentions |
| **Trend Signals** | https://magicbot.beansmile.ai/bots/trend_signals |

## Cross-bot selection

Choose by the job to finish, not by the AI assistant in use. All installed bots work through the same account connection.

- **Image Generation vs Ecommerce Image:** use Image Generation for general creative briefs, illustrations, concept art, campaign visuals, and flexible edits. Use Ecommerce Image when the output must be store-ready product imagery such as lifestyle scenes, clean backgrounds, model showcases, detail close-ups, or posters. Ecommerce Image benefits from attached product reference photos when product fidelity matters.
- **SEO Listing Optimizer vs Shopify GEO Evaluation:** use SEO Listing Optimizer to improve one listing from a public product URL or pasted listing text for a target market. Use Shopify GEO Evaluation for a storefront-level, evidence-oriented assessment of a public Shopify store. GEO Evaluation is not a single-listing rewrite, and SEO Listing Optimizer is not a full GEO scorecard.
- **Shopify GEO Evaluation needs a public Shopify URL:** a private, password-protected, or non-Shopify URL is not a valid substitute. The bot checks the public storefront surface and does not access a private customer account or change the store automatically.
- **GEO patch pack:** after a completed evaluation, ask for an approvable patch pack and an agent-readiness evidence checklist. Drafts remain pending seller approval, and nothing is written to Shopify Admin in this flow.
- **Support Reply Assistant never sends:** it drafts customer replies, FAQ entries, and tone checks from ticket context and saved knowledge. Every result is marked pending review; the bot does not send email, chat, SMS, or social messages.
- **BrandLab Translation needs a glossary:** provide brand guidelines and a glossary so translated titles, descriptions, pages, and SEO fields keep consistent brand voice. Review and approval happen before approved changes are exported.
- **AI Visibility vs Shopify GEO Evaluation:** use AI Visibility to check whether the brand appears in observable public search evidence for 3–10 real buyer questions. Use Shopify GEO Evaluation for the on-site storefront readiness scorecard. They complement each other.
- **Intelligence bots need public sources:** Competitor Intel, Brand Mentions, and Trend Signals work from public pages and public search results. They do not log in to private systems, invent citations, post content, contact people, or guarantee complete platform coverage.

## End-to-end examples

### New product listing

1. **Product Copywriter** turns supplied product facts into a title, description, bullets, and SEO fields in the seller's brand voice.
2. **Ecommerce Image** creates store-ready product imagery from the approved brief and any reference photos.
3. **SEO Listing Optimizer** reviews the public product URL or pasted listing text for a target market and returns keyword gaps plus title, meta, and description rewrite suggestions.
4. The seller reviews the suggestions and decides what to publish. Magic Bot does not update the store automatically.

### Store readiness review

1. **Shopify GEO Evaluation** assesses a public Shopify storefront and returns an evidence-oriented scorecard with gaps and next steps.
2. The seller reviews the findings and fixes public surfaces such as the site's agent guide, FAQ, product copy, structured public information, and policies.
3. **AI Visibility** can then check observable public search evidence for real buyer questions.
4. Re-run the relevant bot later to compare point-in-time evidence; a score does not guarantee search, AI, or commercial results.

### Brand-voice translation

1. Upload or save brand guidelines and a glossary in the account or bot knowledge.
2. **BrandLab Translation** translates catalog content and checks consistency against those materials.
3. The seller reviews and approves changes before export.

## Billing facts

- Lead price: occasional GEO diagnosis from $5. No $95/mo plan is required to run one GEO check.
- Wallet units are prepaid credits shared across installed bots. Public packs are one-time purchases.
- Public credit packs: $5 → 500 credits; $10 → 1,000 credits; $100 → 10,000 credits; $1,000 → 105,000 credits.
- New accounts receive 100 trial credits.
- Bot work reserves credits before the work starts. It settles to actual billable usage, rounded up. Unused reserved credits are released.
- Prepaid credits that have not been consumed stay in the wallet for future bot work. Credit balances are non-transferable.
- Stripe recharge is live. Customers sign in and choose a pack in the console.
- Typical usage: every run settles from the billable credits recorded for that run. One Shopify GEO Evaluation often settles in single-digit credits; the public self-audit of magicbot.beansmile.ai recorded a 33/100 (D) baseline as job 774b3907-3cb7-4ea1-a165-f01ee3c90124 and settled 8 credits. Baseline recorded; remediation shipped; rescored result not claimed.
- Magic Bot is on-demand jobs inside Cursor / Codex / Grok Bot or a similar assistant, not a daily prompt-monitoring SaaS dashboard.

## Support, refunds, and billing disputes

- Product, account, installation, and billing support: support@beansmile.com.
- Privacy requests: privacy@beansmile.com.
- For a billing dispute or refund question, email support@beansmile.com with the account email and the relevant charge or ledger details.
- Unused prepaid credits stay in the wallet for future bot work. Unless required by law or expressly stated at purchase, consumed credits and completed work are non-refundable.
- Support is handled by email; do not invent phone hours, a street address, or a response-time promise.
- Never ask a seller to share a password, full card number, or API key in a support message.

## Common pitfalls

- **GEO needs the right input:** Shopify GEO Evaluation needs a public Shopify URL. A private, password-protected, or non-Shopify URL is not a valid substitute.
- **Support does not send:** every Support Reply Assistant result is a draft for human review.
- **Credits are prepaid:** the wallet is not a subscription and does not imply unlimited usage. Reserve, settlement, and release entries are visible in the ledger.
- **Results are evidence, not guarantees:** scores, recommendation visibility, and market intelligence do not guarantee search, AI, or commercial outcomes.
- **No invented facts:** product claims, prices, measurements, certifications, citations, and customer logos must come from supplied evidence.

## Policy and contact links

- Privacy: https://magicbot.beansmile.ai/legal/privacy
- Terms: https://magicbot.beansmile.ai/legal/terms
- Billing and credit packs: https://magicbot.beansmile.ai/billing
- FAQ: https://magicbot.beansmile.ai/faq
- About: https://magicbot.beansmile.ai/about
- Contact: https://magicbot.beansmile.ai/contact
- Examples, anonymized before / after cases, and representative assistant sessions: https://magicbot.beansmile.ai/examples
- Install in Cursor: https://magicbot.beansmile.ai/install
- Public plugin repository: https://github.com/jundihuang/magic-bot-cursor-plugin
- Agent guide: https://magicbot.beansmile.ai/agents.md
- Bot catalog: https://magicbot.beansmile.ai/bots
- Support: support@beansmile.com
- Privacy requests: privacy@beansmile.com

## 中文摘要

魔偶（Magic Bot）是 Beansmile 提供的托管 SaaS bot 目录，不是 Shopify 商户店铺。用户按任务安装专业 bot，并用预付 credits 在一个账户中运行图片、文案、品牌翻译、客服草稿、Shopify 电商和情报工作。图片生成适合通用创意，电商生图适合店铺商品图片；SEO Listing 优化改进单个 Listing，Shopify GEO 评测评估公开 Shopify 店铺；BrandLab 翻译需要品牌指南和术语表；客服回复助手只生成待审草稿，不会发送消息。钱包使用预付 credits；偶发 GEO 诊断 $5 起，不必 $95/月 才能跑一次；新账户获赠 100 credits；Stripe 充值已上线。公开自审任务 774b3907-3cb7-4ea1-a165-f01ee3c90124 结算 8 credits，基线 33/100（D）；修复已上线，但不声称重新评分结果。未使用的预付 credits 会留在钱包中；计费争议请发送邮件至 support@beansmile.com。Shopify GEO 评测需要公开的 Shopify 店铺网址。