Back to Details

bitrefill-website

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Bitrefill Website Skill

Bitrefill网站Skill

Use this skill when the user wants to explore Bitrefill (bitrefill.com): learn about products, search, compare, or understand pricing and availability. Bitrefill sells digital goods (gift cards, mobile top-ups, eSIMs) and offers Bitcoin/Lightning services. All products are delivered digitally.
Programmatic access & purchases: For searching via API, buying products, managing orders, or any automated workflow, use the bitrefill-cli skill instead. This skill is browse-only — it helps users navigate and understand the website.
当用户想要探索Bitrefill（bitrefill.com）：了解产品、搜索、对比或者查询价格和库存时，可以使用此skill。Bitrefill售卖数字商品（礼品卡、手机话费流量充值、eSIM），并提供Bitcoin/Lightning相关服务。所有产品均为数字交付。
程序化访问与购买： 如需通过API搜索、购买产品、管理订单或者任何自动化工作流，请使用bitrefill-cli skill。本skill仅支持浏览功能，用于帮助用户导航和了解该网站。

When to Use This Skill

何时使用此Skill

Activate when the user:
  • Mentions Bitrefill or bitrefill.com
  • Asks how to search, find, or compare products on Bitrefill
  • Needs information (pricing, availability, country restrictions, denominations)
  • Wants to understand what Bitrefill offers or how a product type works
Redirect to bitrefill-cli when the user wants to:
  • Buy a product, make a purchase, or pay with crypto
  • Use the Bitrefill API or MCP endpoint programmatically
  • Manage orders or invoices
  • Perform any automated or CLI-based workflow
If the request is vague (e.g. "I need a gift"), ask what type of product and for whom (country/interests).
激活时机：当用户：
  • 提到Bitrefill或bitrefill.com
  • 询问如何在Bitrefill上搜索、查找或对比产品
  • 需要（价格、库存、国家限制、面额）相关信息
  • 想要了解Bitrefill提供的服务或者某类产品的使用规则
如需执行以下操作请跳转至bitrefill-cli：
  • 购买产品、下单或者使用加密货币支付
  • 程序化使用Bitrefill API或MCP endpoint
  • 管理订单或发票
  • 执行任何自动化或基于CLI的工作流
如果用户请求比较模糊（例如"我需要一份礼物"），请询问产品类型以及收礼方相关信息（所在国家/兴趣爱好）。

Quick Decision: What Does the User Want to Do?

快速判断：用户想要做什么？

User intent?
├─ Learn what Bitrefill offers / product types     → See "Product types at a glance" below; details in references/product-types.md
├─ Search or browse for a product                 → references/search-and-browse.md
└─ Get detailed info (price, country, how it works)→ references/search-and-browse.md
User intent?
├─ Learn what Bitrefill offers / product types     → See "Product types at a glance" below; details in references/product-types.md
├─ Search or browse for a product                 → references/search-and-browse.md
└─ Get detailed info (price, country, how it works)→ references/search-and-browse.md

Product Types at a Glance

产品类型概览

Product typeWhat it isMain URLLoad details when needed
Gift cardsDigital gift cards (shopping, streaming, gaming, food, travel)bitrefill.com/{country}/{lang}/gift-cards/references/product-types.md, references/supported-categories.md
Mobile top-upsPrepaid airtime/data for a phone number (200+ countries)bitrefill.com/refill/references/product-types.md
eSIMsTravel data plans (data-only, QR activation, 190+ countries)bitrefill.com/esim/all-destinations or bitrefill.com/{country}/{lang}/esims/references/product-types.md
Bitcoin / LightningChannel opening, liquidity, payment toolsbitrefill.com (relevant sections)references/product-types.md (brief)
Account & AuthSignup, login, password reset, referral programbitrefill.com/signup, /loginreferences/account-and-auth.md
Critical: Many products are country- or region-specific. Always confirm or infer the user's country (and, for top-ups, carrier) before recommending a product or flow.
  • Country in URL: The first path segment is country, the second is language (e.g. 
    /us/en/gift-cards/
    , 
    /mx/es/gift-cards/
    ). The country segment filters the inventory shown to gift cards usable in that country. To see a specific country's inventory, use that country in the URL.
  • Geolock: Purchasability is enforced at IP level, not by the URL. If a product is not purchasable, it is due to the user's IP/location, not the country chosen in the URL.
产品类型产品说明主URL按需加载详情
Gift cards数字礼品卡（购物、流媒体、游戏、餐饮、旅行类）bitrefill.com/{country}/{lang}/gift-cards/references/product-types.md, references/supported-categories.md
Mobile top-ups手机号码预付费话费/流量充值（覆盖200多个国家）bitrefill.com/refill/references/product-types.md
eSIMs旅行数据套餐（仅含流量，二维码激活，覆盖190多个国家）bitrefill.com/esim/all-destinations 或 bitrefill.com/{country}/{lang}/esims/references/product-types.md
Bitcoin / Lightning通道开通、流动性、支付工具bitrefill.com（相关板块）references/product-types.md（简要说明）
Account & Auth注册、登录、密码重置、推荐计划bitrefill.com/signup, /loginreferences/account-and-auth.md
重要提示： 很多产品仅限特定国家或地区使用。在推荐产品或流程前，请务必确认或推断用户所在国家（如果是充值的话还需要确认运营商）。
  • URL中的国家标识： 路径的第一段是国家，第二段是语言（例如 
    /us/en/gift-cards/
    、
    /mx/es/gift-cards/
    ）。国家段会过滤显示的库存，仅展示可在该国家使用的礼品卡。如需查看特定国家的库存，请在URL中使用对应国家标识。
  • 地域锁： 购买权限是在IP层级校验的，而非URL。如果某产品无法购买，原因是用户的IP/所在地，而非URL中选择的国家。

Task Flows (High Level)

任务流程（概览）

Browse or search

浏览或搜索

  1. Identify product type (gift card / top-up / eSIM) and country (and carrier for top-ups if known).
  2. For quick discovery of gift cards, send the user directly to search results: 
    https://www.bitrefill.com/{country}/{lang}/gift-cards/?q={query}
    (e.g. 
    https://www.bitrefill.com/us/en/gift-cards/?q=amazon
    ) — no need to navigate from the home page.
  3. For eSIM discovery by destination, send the user to bitrefill.com/esim/all-destinations to browse 190+ countries/regions.
  4. Otherwise direct to the right section or use site search; help filter by category, brand, or amount.
  5. For depth (categories, brands, denominations): references/search-and-browse.md, references/supported-categories.md.
  6. Category = path. To list a category (or subcategory), use 
    /{country}/{lang}/gift-cards/{category-slug}/
    .
  7. Subcategories: Some categories have subcategories (e.g. travel → flights, train, bus). Same path pattern; slug = subcategory.
  8. Listings filters & sort: Gift-card listings (all / category / subcategory) support query params: filters — 
    redemptionMethod
    (online|instore), 
    minRating
    (2–5), 
    minRewards
    (1–10 cashback); sort — 
    s=2
    (A–Z), 
    s=3
    (recently added), 
    s=4
    (cashback); default = popularity. See references/search-and-browse.md.
  1. 确定产品类型（礼品卡/充值/eSIM）和国家（如果是充值的话尽量获取运营商信息）。
  2. 如需快速查找礼品卡，可直接将用户引导至搜索结果页：
    https://www.bitrefill.com/{country}/{lang}/gift-cards/?q={query}
    （例如 
    https://www.bitrefill.com/us/en/gift-cards/?q=amazon
    ），无需从首页开始导航。
  3. 如需按目的地查找eSIM，可将用户引导至 bitrefill.com/esim/all-destinations 浏览190多个国家/地区的套餐。
  4. 其他情况可引导至对应板块或者使用站内搜索，帮助用户按类别、品牌或金额筛选。
  5. 如需更深度信息（类别、品牌、面额）：参考 references/search-and-browse.md、references/supported-categories.md。
  6. 类别对应路径： 如需列出某个类别（或子类别），使用路径 
    /{country}/{lang}/gift-cards/{category-slug}/
    。
  7. 子类别： 部分类别包含子类别（例如旅行→机票、火车、巴士），使用相同的路径规则，slug对应子类别即可。
  8. 列表筛选与排序： 礼品卡列表（全部/类别/子类别）支持查询参数：筛选 — 
    redemptionMethod
    （online|instore）、
    minRating
    （2–5）、
    minRewards
    （1–10 返现）；排序 — 
    s=2
    （A-Z）、
    s=3
    （最新上架）、
    s=4
    （返现）；默认按热门度排序。详见references/search-and-browse.md。

Tips and Common Pitfalls

提示与常见误区

  • Country first: Use the country in the URL to show the right inventory (cards usable in that country). Region-locked products (e.g. Amazon US vs UK) are the main source of errors — align product country with the user's.
  • Geolock vs URL: Whether a product can be bought is determined by the user's IP (geolock), not by the country in the URL. The URL only controls which inventory is listed.
  • Refunds: Digital goods are typically non-refundable once delivered; set expectations before purchase.
  • 国家优先： 使用URL中的国家标识展示对应库存（可在该国使用的卡）。地区限制产品（例如美国亚马逊vs英国亚马逊）是错误的主要来源，请确保产品对应的国家与用户所在国家一致。
  • 地域锁 vs URL： 产品是否可购买由用户IP（地域锁）决定，而非URL中的国家。URL仅控制展示的库存列表。
  • 退款规则： 数字产品交付后通常不支持退款，请在购买前明确告知用户。

Limitations

限制

  • No scraping: Cloudflare blocks automated access to www.bitrefill.com. Do not use firecrawl or direct scraping — requests return 403.
  • No API access: This skill does not use the Bitrefill API or MCP endpoint. For programmatic access (search, buy, order management), use the bitrefill-cli skill.
  • 禁止爬取： Cloudflare会拦截对www.bitrefill.com的自动化访问。请勿使用firecrawl或直接爬取，请求会返回403。
  • 无API访问： 本skill不调用Bitrefill API或MCP endpoint。如需程序化访问（搜索、购买、订单管理），请使用bitrefill-cli skill。

References

参考资料

Load only when the agent needs more detail:
ReferenceUse when
product-typesExplaining gift cards vs top-ups vs eSIMs, or how each works on the site
search-and-browseUser wants to find or filter products
supported-categoriesListing categories or popular brands (gift cards, etc.)
仅当Agent需要更多详情时加载：
参考文档使用场景
product-types解释礼品卡、充值、eSIM的区别，或者说明每类产品在网站上的使用规则
search-and-browse用户想要查找或筛选产品时
supported-categories列出类别或热门品牌（礼品卡等）时