mirror of
https://github.com/simstudioai/sim.git
synced 2026-02-14 00:15:09 -05:00
97 lines
3.5 KiB
Plaintext
97 lines
3.5 KiB
Plaintext
---
|
|
title: Google Books
|
|
description: Search and retrieve book information
|
|
---
|
|
|
|
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
|
|
|
<BlockInfoCard
|
|
type="google_books"
|
|
color="#FFFFFF"
|
|
/>
|
|
|
|
## Usage Instructions
|
|
|
|
Search for books using the Google Books API. Find volumes by title, author, ISBN, or keywords, and retrieve detailed information about specific books including descriptions, ratings, and publication details.
|
|
|
|
|
|
|
|
## Tools
|
|
|
|
### `google_books_volume_search`
|
|
|
|
Search for books using the Google Books API
|
|
|
|
#### Input
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `apiKey` | string | Yes | Google Books API key |
|
|
| `query` | string | Yes | Search query. Supports special keywords: intitle:, inauthor:, inpublisher:, subject:, isbn: |
|
|
| `filter` | string | No | Filter results by availability \(partial, full, free-ebooks, paid-ebooks, ebooks\) |
|
|
| `printType` | string | No | Restrict to print type \(all, books, magazines\) |
|
|
| `orderBy` | string | No | Sort order \(relevance, newest\) |
|
|
| `startIndex` | number | No | Index of the first result to return \(for pagination\) |
|
|
| `maxResults` | number | No | Maximum number of results to return \(1-40\) |
|
|
| `langRestrict` | string | No | Restrict results to a specific language \(ISO 639-1 code\) |
|
|
|
|
#### Output
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ---- | ----------- |
|
|
| `totalItems` | number | Total number of matching results |
|
|
| `volumes` | array | List of matching volumes |
|
|
| ↳ `id` | string | Volume ID |
|
|
| ↳ `title` | string | Book title |
|
|
| ↳ `subtitle` | string | Book subtitle |
|
|
| ↳ `authors` | array | List of authors |
|
|
| ↳ `publisher` | string | Publisher name |
|
|
| ↳ `publishedDate` | string | Publication date |
|
|
| ↳ `description` | string | Book description |
|
|
| ↳ `pageCount` | number | Number of pages |
|
|
| ↳ `categories` | array | Book categories |
|
|
| ↳ `averageRating` | number | Average rating \(1-5\) |
|
|
| ↳ `ratingsCount` | number | Number of ratings |
|
|
| ↳ `language` | string | Language code |
|
|
| ↳ `previewLink` | string | Link to preview on Google Books |
|
|
| ↳ `infoLink` | string | Link to info page |
|
|
| ↳ `thumbnailUrl` | string | Book cover thumbnail URL |
|
|
| ↳ `isbn10` | string | ISBN-10 identifier |
|
|
| ↳ `isbn13` | string | ISBN-13 identifier |
|
|
|
|
### `google_books_volume_details`
|
|
|
|
Get detailed information about a specific book volume
|
|
|
|
#### Input
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `apiKey` | string | Yes | Google Books API key |
|
|
| `volumeId` | string | Yes | The ID of the volume to retrieve |
|
|
| `projection` | string | No | Projection level \(full, lite\) |
|
|
|
|
#### Output
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ---- | ----------- |
|
|
| `id` | string | Volume ID |
|
|
| `title` | string | Book title |
|
|
| `subtitle` | string | Book subtitle |
|
|
| `authors` | array | List of authors |
|
|
| `publisher` | string | Publisher name |
|
|
| `publishedDate` | string | Publication date |
|
|
| `description` | string | Book description |
|
|
| `pageCount` | number | Number of pages |
|
|
| `categories` | array | Book categories |
|
|
| `averageRating` | number | Average rating \(1-5\) |
|
|
| `ratingsCount` | number | Number of ratings |
|
|
| `language` | string | Language code |
|
|
| `previewLink` | string | Link to preview on Google Books |
|
|
| `infoLink` | string | Link to info page |
|
|
| `thumbnailUrl` | string | Book cover thumbnail URL |
|
|
| `isbn10` | string | ISBN-10 identifier |
|
|
| `isbn13` | string | ISBN-13 identifier |
|
|
|
|
|