{"id":52061700,"url":"https://github.com/zaryab2000/decipher-ranker","last_synced_at":"2026-08-02T23:01:31.081Z","repository":{"id":371150243,"uuid":"1283770181","full_name":"zaryab2000/decipher-ranker","owner":"zaryab2000","description":"a agent-discovery optimizer for headless merchants","archived":false,"fork":false,"pushed_at":"2026-07-27T16:04:26.000Z","size":527,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-27T18:05:28.169Z","etag":null,"topics":["agentic-ai","agentic-commerce"],"latest_commit_sha":null,"homepage":"https://decipherranker.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zaryab2000.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-29T08:13:25.000Z","updated_at":"2026-07-21T18:32:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zaryab2000/decipher-ranker","commit_stats":null,"previous_names":["zaryab2000/decipher-ranker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zaryab2000/decipher-ranker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaryab2000%2Fdecipher-ranker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaryab2000%2Fdecipher-ranker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaryab2000%2Fdecipher-ranker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaryab2000%2Fdecipher-ranker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zaryab2000","download_url":"https://codeload.github.com/zaryab2000/decipher-ranker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaryab2000%2Fdecipher-ranker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36211735,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-08-02T02:00:06.915Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","agentic-commerce"],"created_at":"2026-08-02T23:01:29.261Z","updated_at":"2026-08-02T23:01:31.073Z","avatar_url":"https://github.com/zaryab2000.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# decipher-ranker\n\n**The merchant intelligence platform for the x402 micropayment ecosystem.**\n\nRankings, competitive analysis, and actionable insights for every API provider in the x402 marketplace. Free basic reports. Paid deep dives ($0.03 USDC). All powered by a proprietary scoring formula that no merchant portal provides.\n\n## The Problem\n\nx402 merchants list their APIs on marketplaces like Coinbase Bazaar — but have zero visibility into their competitive position. No analytics. No benchmarks. No way to know if they're overpriced, underperforming, or invisible.\n\nThe marketplace provides raw call counts and nothing else.\n\n## What decipher-ranker Provides\n\n|                              | Coinbase Bazaar               | decipher-ranker                                                       |\n| ---------------------------- | ----------------------------- | --------------------------------------------------------------------- |\n| **Ranking**                  | Flat catalog with no ordering | Ranked leaderboard by decipher score                                  |\n| **Categories**               | Raw tags, no structure        | Structured categories with merchant counts and median pricing         |\n| **Competitive intelligence** | None                          | Top-10 competitors with gap analysis (missing tags, missing keywords) |\n| **Pricing benchmarks**       | Raw atomic amounts            | Your price vs category median, minimum, maximum, percentile           |\n| **Buyer insights**           | 30d unique payer count        | Buyer diversity score, concentration risk (HHI-derived)               |\n| **Trend history**            | None                          | 30-day time-series of rank and score changes                          |\n| **Recommendations**          | None                          | Algorithmic tips based on actual gaps vs competitors                  |\n\n## Architecture\n\n```\nCoinbase Bazaar API                     decipher-ranker\n+----------------------------+         +--------------------------------+\n| Raw resource catalog       |         | 6-stage Data Pipeline          |\n| - resource URL             | ------\u003e |                                |\n| - tags                     |         | 1. fetchAllBazaarResources     |\n| - accept amounts (atomic)  |         | 2. upsertCatalog               |\n| - l30d calls / payers      |         | 3. assignAllMerchantCategories |\n+----------------------------+         | 4. scoreAllMerchants (RANKER)  |\n                                       | 5. refreshCategoryCache        |\n                                       | 6. writeDailySnapshot          |\n                                       +--------------------------------+\n                                                  |\n                                                  v\n                                       +--------------------------------+\n                                       | Neon Postgres                  |\n                                       | merchants, resources,          |\n                                       | categories, trends, reports    |\n                                       +--------------------------------+\n                                          |                    |\n                                          v                    v\n                              +---------------+     +-----------------+\n                              | Public API    |     | Dashboard       |\n                              | (x402/SIWX)   |     | (direct DB)     |\n                              +---------------+     +-----------------+\n```\n\nThe **ranker score** formula that powers every ranking and report:\n\n```\n0.40·volume + 0.25·buyerDiversity + 0.05·reliability + 0.15·listingQuality + 0.15·recency\n```\n\nEach component maps to an action a merchant can take: drive more volume, diversify buyers, maintain uptime, write better descriptions, stay active. The dashboard makes every component visible and explainable.\n\n## Quick Start\n\n```bash\n# Clone and install\ngit clone https://github.com/zaryab2000/decipher-ranker-dev.git\ncd decipher-ranker-dev\nnpm install\n\n# Configure environment\ncp .env.example .env.local\n# Fill in: POSTGRES_URL, KV_REST_API_URL, KV_REST_API_TOKEN,\n#          CDP_API_KEY_ID, CDP_API_KEY_SECRET, EVM_PAYEE_ADDRESS,\n#          BASE_URL, CRON_SECRET\n\n# Seed the database from Coinbase Bazaar (~5 min)\nnpm run seed\n\n# Start dev server\nnpm run dev\n```\n\nThe dev server starts at `http://localhost:3000`. Free endpoints are available immediately:\n\n```bash\ncurl http://localhost:3000/api/categories\ncurl \"http://localhost:3000/api/leaderboard?limit=10\"\n```\n\n## API Endpoints\n\n| Endpoint                    | Method | Auth   | Cost  | Description                                                        |\n| --------------------------- | ------ | ------ | ----- | ------------------------------------------------------------------ |\n| `/api/preview`              | GET    | None   | Free  | Quick merchant lookup by domain — score, grade, rank, category     |\n| `/api/categories`           | GET    | None   | Free  | All categories with merchant counts and top-3 merchants            |\n| `/api/leaderboard`          | GET    | None   | Free  | Top N merchants ranked by decipher score                           |\n| `/api/report/origin`        | POST   | SIWX   | Free  | Basic report: rank, price position, listing quality, tips          |\n| `/api/report/competitive`   | POST   | x402   | $0.03 | Full competitive analysis with gap analysis and pricing benchmarks |\n| `/api/report/merchant`      | POST   | x402   | $0.03 | Merchant deep-dive: volume, buyers, trends, concentration risk     |\n| `/api/cron/refresh-catalog` | GET    | Bearer | —     | Trigger full pipeline refresh                                      |\n| `/openapi.json`             | GET    | None   | —     | Auto-generated OpenAPI 3.1 spec                                    |\n| `/.well-known/x402`         | GET    | None   | —     | x402 service descriptor                                            |\n| `/llms.txt`                 | GET    | None   | —     | LLM-readable service summary                                       |\n\nFull endpoint schemas and response shapes: [`docs/architecture/decipher-ranker-x402-service.md`](docs/architecture/decipher-ranker-x402-service.md)\n\n## Build and Test\n\n```bash\nnpm run dev          # Next.js dev server\nnpm run build        # Production build\nnpm run lint         # ESLint (next lint)\nnpm run typecheck    # tsc --noEmit\nnpm test             # vitest run (336 tests)\nnpm run test:watch   # vitest in watch mode\n```\n\n## Registry Listings\n\ndecipher-ranker is registered in both agent-payment ecosystems:\n\n| Registry | Listing URL | Protocols |\n|---|---|---|\n| **x402scan** | https://www.x402scan.com/server/d683a3a0-e920-4ebb-9f5d-2f3e0fe25803 | x402 (USDC on Base) |\n| **MPPscan** | https://www.mppscan.com/server/a7118bdd8bcabdab2587bdd7c01e58c8fe31ceb50932a7fc3db81cfcbf549bfa | MPP (USDC on Tempo) |\n\nInstall on any AgentCash-compatible client:\n\n```bash\nnpx agentcash add https://decipherranker.com\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaryab2000%2Fdecipher-ranker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzaryab2000%2Fdecipher-ranker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaryab2000%2Fdecipher-ranker/lists"}