bitrefill-website
2
总安装量
2
周安装量
#69403
全站排名
安装命令
npx skills add https://github.com/bitrefill/agents --skill bitrefill-website
Agent 安装分布
mcpjam
2
qwen-code
2
claude-code
2
junie
2
windsurf
2
zencoder
2
Skill 文档
Bitrefill Website Skill
Use this skill when the user wants to do anything on Bitrefill (bitrefill.com): learn about products, search, compare, buy, or use what they bought. Bitrefill sells digital goods (gift cards, mobile top-ups, eSIMs) and offers Bitcoin/Lightning services; payment can be crypto or card. All products are delivered digitally and usually instantly.
When to Use This Skill
Activate when the user:
- Mentions Bitrefill or bitrefill.com
- Wants to buy gift cards, mobile top-up, or eSIM (with crypto or card)
- Asks how to search, find, or compare products on Bitrefill
- Needs information (pricing, availability, country restrictions, denominations)
If the request is vague (e.g. “I need a gift”), ask what type of product and for whom (country/interests).
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
Product Types at a Glance
| Product type | What it is | Main URL | Load details when needed |
|---|---|---|---|
| Gift cards | Digital gift cards (shopping, streaming, gaming, food, travel) | bitrefill.com/{lang}/{country}/gift-cards/ | references/product-types.md, references/supported-categories.md |
| Mobile top-ups | Prepaid airtime/data for a phone number (200+ countries) | bitrefill.com/refill/ | references/product-types.md |
| eSIMs | Travel data plans (data-only, QR activation, 190+ countries) | bitrefill.com/esim/all-destinations or bitrefill.com/{lang}/{country}/esims/ | references/product-types.md |
| Bitcoin / Lightning | Channel opening, liquidity, payment tools | bitrefill.com (relevant sections) | references/product-types.md (brief) |
| Account & Auth | Signup, login, password reset, referral program | bitrefill.com/signup, /login | references/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.
Task Flows (High Level)
Browse or search
- Identify product type (gift card / top-up / eSIM) and country (and carrier for top-ups if known).
- For quick discovery of gift cards, send the user directly to search results:
https://www.bitrefill.com/{lang}/{country}/gift-cards/?q={query}(e.g.https://www.bitrefill.com/it/en/gift-cards/?q=amazon) â no need to navigate from the home page. - For eSIM discovery by destination, send the user to bitrefill.com/esim/all-destinations to browse 190+ countries/regions.
- Otherwise direct to the right section or use site search; help filter by category, brand, or amount.
- For depth (categories, brands, denominations): references/search-and-browse.md, references/supported-categories.md.
Tips and Common Pitfalls
- Country first: Region-locked products (e.g. Amazon US vs UK) are the main source of errors. Always align product country with the user’s.
- Refunds: Digital goods are typically non-refundable once delivered; set expectations before purchase.
Agent Tools
Use the right tool for each task:
| Tool | When to use |
|---|---|
Official API (api.bitrefill.com/v2) |
Primary for product search, product details, purchases, order management. Requires auth (Bearer token or Basic auth). See docs.bitrefill.com for full reference. |
MCP endpoint (api.bitrefill.com/mcp) |
For Claude Code integration. Provides search-products, product-details, buy-products, list-invoices, list-orders tools via JSON-RPC/SSE. Connect with: claude mcp add --transport http bitrefill https://api.bitrefill.com/mcp |
| Chrome DevTools | Only for visual flows not covered by the API: signup, login, account creation, visual page inspection. |
| NOT recommended: scraping | Cloudflare blocks all automated access to www.bitrefill.com. Do not use firecrawl or direct scraping â requests return 403. |
How we verified: URLs and flows verified via chrome-devtools + API probing on bitrefill.com (2026-02-19).
References
Load only when the agent needs more detail:
| Reference | Use when |
|---|---|
| product-types | Explaining gift cards vs top-ups vs eSIMs, or how each works on the site |
| search-and-browse | User wants to find or filter products |
| supported-categories | Listing categories or popular brands (gift cards, etc.) |