← Back to Skills Marketplace
Amazon Books
by
heardlyapp
· GitHub ↗
· v1.0.3
· MIT-0
192
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install amazon-books
Description
Search books across all sources with summaries and Amazon purchase links. Triggered when user asks about finding, buying, or searching for books.
README (SKILL.md)
amazon-books
Search books across all sources with summaries and Amazon purchase links.
What it does
- Search books by title, author, or keyword across multiple sources
- Return full book descriptions from Google Books API
- Provide direct Amazon purchase links
- Show Heardly summary if available
- Support multiple book sources (Heardly, Google Books, Open Library)
- Return user-friendly formatted text by default
When to use this skill
Use this skill when the user asks:
- "Do you have books by Kevin Kelly?"
- "Where can I buy books about happiness?"
- "Search for books on machine learning"
- "Find me books by Elon Musk"
- "What books are available about AI?"
Installation
clawhub install amazon-books
Usage
const AmazonBooksSkill = require('amazon-books');
const skill = new AmazonBooksSkill();
// Search books (returns formatted text)
const result = await skill.searchBooks({
query: 'Kevin Kelly',
limit: 5
});
console.log(result); // Directly readable text output
Output
Formatted text with:
- Title, author, description
- Amazon purchase link
- Heardly summary (if available)
- Ready to display to users
Data Sources
- Heardly Database (5904 books) — fastest, local
- Google Books API (free, millions of books)
- Open Library API (free, open source)
- Amazon Search Links (no API needed)
License
MIT
Usage Guidance
This skill appears to do what it says: search public book APIs, optionally use a local Heardly data file, and return Amazon search links. It does not ask for any credentials or read system configs. Before installing, consider: (1) Heardly data file (data/books.json) is not included — some features may be missing unless you supply that file; (2) the skill makes outbound HTTPS requests to Google Books and Open Library — verify your environment permits that and you’re comfortable with those network calls; (3) Amazon links are generated as search URLs (clicking them opens Amazon in a browser). If you require offline-only behavior or stricter network controls, review or sandbox the skill accordingly.
Capability Analysis
Type: OpenClaw Skill
Name: amazon-books
Version: 1.0.3
The amazon-books skill is a legitimate tool for searching book information across Google Books, Open Library, and a local database. The implementation in index.js uses standard Node.js modules (https, fs) to perform searches and format results without any external dependencies, sensitive data access, or suspicious execution patterns.
Capability Assessment
Purpose & Capability
Name/description claim searching multiple book sources and providing Amazon links; the code implements Google Books, Open Library, builds Amazon search URLs, and optionally reads a local 'Heardly' data file. Minor note: SKILL.md mentions a local Heardly DB (~5904 books) but the repository does not include a data/books.json file — this only affects availability of Heardly results, not functionality.
Instruction Scope
SKILL.md and code confine actions to searching Google Books/Open Library, reading a local data file if present, and building Amazon links. There are no instructions to read unrelated system files, exfiltrate data, or call unexpected endpoints.
Install Mechanism
No install spec in the registry (instruction-only), and bundled code contains no external download/install steps. The package is a simple Node module/CLI; nothing is fetched from untrusted URLs.
Credentials
The skill requests no environment variables or credentials and only performs network calls to public book APIs and Amazon search. It reads a local data file within its own directory if present — no access to unrelated credentials or config paths.
Persistence & Privilege
always is false, the skill does not modify other skills or system-wide settings, and it does not persist credentials or run background processes. Autonomous invocation is allowed (platform default) but not combined with elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install amazon-books - After installation, invoke the skill by name or use
/amazon-books - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Updated dependencies in package.json for improved stability.
- Enhanced code structure and formatting in index.js.
- Refreshed metadata in _meta.json; no user-facing feature changes.
v1.0.2
- Added CLI support with new cli.js file.
- Expanded skill documentation with usage scenarios, detailed data sources, trigger phrases, and keyword metadata.
- Updated package and meta information for improved discoverability and clarity.
- No breaking changes to the API; skill usage remains the same.
v1.0.1
- Default output is now user-friendly formatted text, making results ready to display to users.
- Documentation updated to reflect the new output format and usage.
- Maintains all previous search, description, and purchase link features.
v1.0.0
- Initial release of amazon-books skill.
- Search books by title, author, or keyword across multiple sources.
- Returns full book descriptions, Amazon purchase links, and publication info.
- Displays Heardly summaries when available.
Metadata
Frequently Asked Questions
What is Amazon Books?
Search books across all sources with summaries and Amazon purchase links. Triggered when user asks about finding, buying, or searching for books. It is an AI Agent Skill for Claude Code / OpenClaw, with 192 downloads so far.
How do I install Amazon Books?
Run "/install amazon-books" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Amazon Books free?
Yes, Amazon Books is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Amazon Books support?
Amazon Books is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Amazon Books?
It is built and maintained by heardlyapp (@heardlyapp); the current version is v1.0.3.
More Skills