What makes BeyondBSR - BookSearch API notable?

1.4K downloads. Trust evidence available

How should BeyondBSR - BookSearch API be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

BeyondBSR - BookSearch API

Search Amazon KDP books on the BeyondBSR public API, retrieve BSR (Best Sellers Rank) history for a single book, and explore the Amazon category taxonomy (br... Skill: BeyondBSR - BookSearch API Owner: ramius88 Summary: Search Amazon KDP books on the BeyondBSR public API, retrieve BSR (Best Sellers Rank) history for a single book, and explore the Amazon category taxonomy (br... Tags: latest:1.0.9 Version history: v1.0.9 | 2026-06-03T11:57:49.641Z | user - Removed the skill-card.md file. - No changes to functionality or documentation content. v1.0.8 | 2026-06-01T13:57:00.217Z

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.4k

Updated

Oct 10, 2026

Version

1.0.9

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.4K downloadsadoption · observed Oct 10, 2026
Latest release: 1.0.9release · observed Jun 3, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s176q0vwbyv9fyg5jsxfm2pjv1857303:booksearch-api

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-ramius88-booksearch-api/snapshot"

Documentation

CLAWHUB

144,897 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: booksearch-api
description: Search Amazon KDP books on the BeyondBSR public API, retrieve BSR (Best Sellers Rank) history for a single book, and explore the Amazon category taxonomy (browse nodes) for any supported marketplace. Each book-search result now ships its full root → leaf category ancestor chain(s) inline, so the skill can aggregate market-opportunity reports by macro/sub category without follow-up calls. Use this skill whenever the user wants to discover, filter, or research self-published or traditionally published books on Amazon by BSR, category, keyword, royalty range, rating, reviews, publication date, binding type, or marketplace (currently only the US and FR Amazon marketplaces are populated with data — more coming soon); when the user wants the BSR timeline of a specific ASIN over the last N days; when the user wants to look up Amazon category codes (browse node IDs), walk the category tree (children, ancestors/breadcrumb), or search categories by name to use as filters in book search; or when the user wants to group/aggregate search results by macro category (e.g. "how many Personal Finance opportunities, broken down by sub-category?"). Typical intents include KDP niche research, low-competition book discovery, sales estimation, royalty/revenue projection, competitor analysis, paperback/hardcover filtering, bulk listing of books matching numeric/textual criteria, single-ASIN BSR history charts, resolving a human-readable category name (e.g. "manga", "self-help") into the Amazon `catId` to pass to `categoryIds` in book search, and producing category-grouped market-opportunity summaries from a single search response. Do not use for price-history timelines, review/rating timelines, or account/user data — only book search, BSR history, and category browsing are exposed.
metadata:
clawdbot:
requires:
env:
- BOOKSEARCH_API_KEY
---

# BookSearch API

## ⚠️ API Access & Beta Program

The BeyondBSR BookSearch API is currently in **private beta**. This skill requires an API key (`BOOKSEARCH_API_KEY`) which is **not publicly available** at this time.

Users interested in accessing Amazon KDP book data (BSR history, reviews, categories, keyword research) can apply to the early adopter program by contacting **[email protected]**. Requests are reviewed individually and approved keys are issued on a case-by-case basis.

Without a valid key, all endpoints below will return `401 Unauthorized`.

---

Programmatic search over the BeyondBSR book catalogue, BSR history retrieval for a single book, and Amazon category taxonomy browsing. Six endpoints, JSON in / JSON out, API-key auth.

## When to use this skill

Use it when the user asks to:

- Find books matching numeric filters: BSR range, rating, reviews count, royalty, page count age, publication recency.
- Discover niches by keyword inclusion/exclusion or Amazon category IDs.
- Filter by marketplace (currently US / Amazon.com and FR / Amazon.fr only).
- Distin

_meta.json

{
  "ownerId": "kn71bkxxw77zyvcjdxzqpwcs658570bb",
  "slug": "booksearch-api",
  "version": "1.0.9",
  "publishedAt": 1780487869641
}

skill-card.md

## Description:

Searches the BeyondBSR public API for Amazon KDP books, retrieves single-ASIN BSR history, and browses Amazon category taxonomy for supported marketplaces.

This skill is ready for commercial/non-commercial use.

## Publisher:

[ramius88](https://clawhub.ai/user/ramius88)

### License/Terms of Use:

MIT-0

## Use Case:

External users and developers use this skill for KDP niche research, competitor analysis, sales and royalty estimates, BSR history checks, and Amazon category lookup through the BeyondBSR API.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill requires a private beta API key and sends book-search queries to api.beyondbsr.com.

Mitigation: Install only when the publisher is trusted, keep BOOKSEARCH_API_KEY out of user-facing output, and avoid exposing it in logs or screenshots.

Risk: The skill depends on external API availability, authorization, rate limits, and marketplace coverage.

Mitigation: Handle 401, 429, 404, and validation errors as documented, and limit use to populated US and FR marketplace data unless newer server evidence says otherwise.

## Reference(s):

- [ClawHub Skill Page](https://clawhub.ai/ramius88/skills/booksearch-api)
- [Publisher Profile](https://clawhub.ai/user/ramius88)
- [BeyondBSR Book Search API](https://api.beyondbsr.com/api/v1/books/search)
- [BeyondBSR BSR History API](https://api.beyondbsr.com/api/v1/books/{domainId}/{asin}/bsr-history?days={1..365})
- [BeyondBSR Categories API](https://api.beyondbsr.com/api/v1/categories?domainId={..}&depth={0..5}&includeFiction={true|false})

## Skill Output:

**Output Type(s):** [API Calls, Markdown, Code, Shell commands, Guidance]

**Output Format:** [Markdown with JSON and shell command examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [May include API request bodies, parsed result summaries, BSR timelines, category mappings, and market-opportunity analysis.]

## Skill Version(s):

1.0.9 (source: server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 19h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular