# Send Shop on Bitrefill to your agent
Use the source page and any available docs to guide the install because the item currently does not return a direct package file.
## Fast path
- Open the source page via Open source listing.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "bitrefill-website",
    "name": "Shop on Bitrefill",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/marcopesani/bitrefill-website",
    "canonicalUrl": "https://clawhub.ai/marcopesani/bitrefill-website",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/bitrefill-website",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bitrefill-website",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/search-and-browse.md",
      "references/supported-categories.md",
      "references/product-types.md"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "bitrefill-website",
      "status": "source_issue",
      "reason": "not_found",
      "recommendedAction": "review_source",
      "checkedAt": "2026-05-08T19:15:42.435Z",
      "expiresAt": "2026-05-09T19:15:42.435Z",
      "httpStatus": 404,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bitrefill-website",
      "contentType": "text/plain",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bitrefill-website",
        "contentDisposition": null,
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "bitrefill-website"
      },
      "scope": "item",
      "summary": "Known item issue.",
      "detail": "This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.",
      "primaryActionLabel": "Open source listing",
      "primaryActionHref": "https://clawhub.ai/marcopesani/bitrefill-website"
    },
    "validation": {
      "installChecklist": [
        "Open the source listing and confirm there is a real package or setup artifact available.",
        "Review SKILL.md before asking your agent to continue.",
        "Treat this source as manual setup until the upstream download flow is fixed."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/bitrefill-website",
    "downloadUrl": "https://openagent3.xyz/downloads/bitrefill-website",
    "agentUrl": "https://openagent3.xyz/skills/bitrefill-website/agent",
    "manifestUrl": "https://openagent3.xyz/skills/bitrefill-website/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/bitrefill-website/agent.md"
  }
}
```
## Documentation

### Bitrefill Website 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.

### When to Use This 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).

### 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 typeWhat it isMain URLLoad details when neededGift cardsDigital gift cards (shopping, streaming, gaming, food, travel)bitrefill.com/{country}/{lang}/gift-cards/references/product-types.md, references/supported-categories.mdMobile top-upsPrepaid airtime/data for a phone number (200+ countries)bitrefill.com/refill/references/product-types.mdeSIMsTravel data plans (data-only, QR activation, 190+ countries)bitrefill.com/esim/all-destinations or bitrefill.com/{country}/{lang}/esims/references/product-types.mdBitcoin / 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.

### 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/{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.
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.
Category = path. To list a category (or subcategory), use /{country}/{lang}/gift-cards/{category-slug}/.
Subcategories: Some categories have subcategories (e.g. travel → flights, train, bus). Same path pattern; slug = subcategory.
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.

### 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.

### 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.

### References

Load only when the agent needs more detail:

ReferenceUse whenproduct-typesExplaining gift cards vs top-ups vs eSIMs, or how each works on the sitesearch-and-browseUser wants to find or filter productssupported-categoriesListing categories or popular brands (gift cards, etc.)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: marcopesani
- Version: 1.2.1
## Source health
- Status: source_issue
- Known item issue.
- This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.
- Health scope: item
- Reason: not_found
- Checked at: 2026-05-08T19:15:42.435Z
- Expires at: 2026-05-09T19:15:42.435Z
- Recommended action: Open source listing
## Links
- [Detail page](https://openagent3.xyz/skills/bitrefill-website)
- [Send to Agent page](https://openagent3.xyz/skills/bitrefill-website/agent)
- [JSON manifest](https://openagent3.xyz/skills/bitrefill-website/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/bitrefill-website/agent.md)
- [Download page](https://openagent3.xyz/downloads/bitrefill-website)