Amazon Books

Search books across all sources with summaries and Amazon purchase links. Triggered when user asks about finding, buying, or searching for books.

Security Scan

The skill's code, instructions, and requirements match its stated purpose (book search + Amazon links); it makes only expected API calls and reads an optional local data file and requests no secrets.

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.

Assessment

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.

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

1. Heardly Database (5904 books) — fastest, local
2. Google Books API (free, millions of books)
3. Open Library API (free, open source)
4. Amazon Search Links (no API needed)

License

MIT