mirror of
https://github.com/simstudioai/sim.git
synced 2026-04-06 03:00:16 -04:00
109 lines
4.3 KiB
Plaintext
109 lines
4.3 KiB
Plaintext
---
|
|
title: Google Books
|
|
description: Search and retrieve book information
|
|
---
|
|
|
|
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
|
|
|
<BlockInfoCard
|
|
type="google_books"
|
|
color="#E0E0E0"
|
|
/>
|
|
|
|
{/* MANUAL-CONTENT-START:intro */}
|
|
[Google Books](https://books.google.com) is Google's comprehensive book discovery and metadata service, providing access to millions of books from publishers, libraries, and digitized collections worldwide.
|
|
|
|
With the Google Books integration in Sim, you can:
|
|
|
|
- **Search for books**: Find volumes by title, author, ISBN, or keyword across the entire Google Books catalog
|
|
- **Retrieve volume details**: Get detailed metadata for a specific book including title, authors, description, ratings, and publication details
|
|
|
|
In Sim, the Google Books integration allows your agents to search for books and retrieve volume details as part of automated workflows. This enables use cases such as content research, reading list curation, bibliographic data enrichment, and knowledge gathering from published works.
|
|
{/* MANUAL-CONTENT-END */}
|
|
|
|
|
|
## 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 |
|
|
|
|
|