# Shakarra

> Shakarra lets shoppers in Nigeria browse and buy products from US retailers (Amazon, Walmart, Target, Best Buy, Costco, Home Depot) with checkout in Naira and delivery to Nigeria.

Shakarra connects Nigerian shoppers to US retailer catalogs. Site search accepts `term` or `q` query parameters; add `store` to filter by retailer slug (`amazon`, `walmart`, `target`, `bestbuy`, `costco`, `homedepot`). Product detail URLs follow `/products/{retailer}/{encoded-product-path}`.

## Product

- [Homepage](https://shop.shakarra.com/): Main storefront and entry point for browsing
- [Product hub](https://shop.shakarra.com/products): Browse the Shakarra product catalog
- [Search](https://shop.shakarra.com/search): Search products across retailers; use `?term=` and optional `?store=`
- [Stores index](https://shop.shakarra.com/stores): List of supported US retailer storefronts on Shakarra

## Stores

- [Amazon](https://shop.shakarra.com/stores/amazon): Amazon products with delivery to Nigeria
- [Walmart](https://shop.shakarra.com/stores/walmart): Walmart products with delivery to Nigeria
- [Target](https://shop.shakarra.com/stores/target): Target products with delivery to Nigeria
- [Best Buy](https://shop.shakarra.com/stores/bestbuy): Electronics, appliances, and tech from Best Buy
- [Costco](https://shop.shakarra.com/stores/costco): Costco bulk and member-value products
- [Home Depot](https://shop.shakarra.com/stores/homedepot): Tools, building materials, and home improvement

## Examples

- [Electronics search](https://shop.shakarra.com/search?term=electronics): Search electronics across all stores
- [Amazon laptop search](https://shop.shakarra.com/search?term=laptops&store=amazon): Retailer-filtered search example

## API

- [Agent action map](https://shop.shakarra.com/agents.json): Callable search and browse actions with typed parameters
- [Agent runbook](https://shop.shakarra.com/agent-instructions.md): Navigation rules and escalation for autonomous agents
- [Product catalog JSON](https://shop.shakarra.com/catalog.json): Machine-readable product index for crawlers and agents
- [Sitemap index](https://shop.shakarra.com/sitemap.xml): XML sitemap index for discoverable public URLs

## Optional

- [Terms of service](https://shop.shakarra.com/terms): Legal terms for using Shakarra
- [Privacy policy](https://shop.shakarra.com/privacy): How Shakarra collects and uses personal data
- [Fashion search](https://shop.shakarra.com/search?term=fashion): Popular category search link
- [Beauty search](https://shop.shakarra.com/search?term=beauty): Popular category search link
- [Home and kitchen search](https://shop.shakarra.com/search?term=home%20%26%20kitchen): Popular category search link
- [Fitness search](https://shop.shakarra.com/search?term=fitness): Popular category search link
- [Office supplies search](https://shop.shakarra.com/search?term=office%20supplies): Popular category search link