Google Books Researcher Dify Plugin

A Dify plugin designed to empower your AI applications with the ability to search and retrieve information about books using the Google Books API.

📚 Overview

This plugin seamlessly integrates with the Google Books service, allowing your Dify-powered agents and chatbots to:

Search for Books: Find books based on general keywords, specific titles, or authors.

Retrieve Key Information: Get details such as the book's title, authors, publication date, a brief description, and a direct link to its preview on Google Books.

✨ Features

Simple Integration: Easily plug into your Dify applications (Chatflow, Agent).

Google Books API Powered: Leverages the robust and comprehensive Google Books database.

Configurable Results: Specify the maximum number of search results to fetch per query (up to 40).

Clear Output: Provides structured JSON output that is easy to parse and present to users.

🚀 Getting Started

To use this plugin, you will need:

A Google Books API Key. You can obtain one from the Google Cloud Console. Ensure the "Google Books API" is enabled for your project.

Your Dify instance (Cloud or Self-hosted).

Installation Steps: Download/Clone: Obtain the plugin files.

Package: Zip the entire dify-books-plugin directory. Ensure the internal structure (plugin.yaml, api.yaml, i18n/en_US.yaml, tools/google_books_researcher.py) is preserved.

Upload to Dify: Go to the "Plugins" section in your Dify workspace and upload the zipped plugin file.

Configure API Key: After uploading, Dify will prompt you to enter your Google Books API Key in the plugin's credentials. Paste your key there and save.

For detailed instructions on how to set up the API key and use the plugin within your Dify application, please refer to the guide.md file.

🛠️ Usage

Once installed and configured, the plugin exposes a tool named Search Books on Google. You can invoke this tool within your Dify workflows (e.g., in a "Tool" node in a Chatflow or via Agent capabilities).

Tool: Search Books on Google Description: Searches for books on Google Books by title, author, or keywords.

Parameters:

query (string, required): The main search query (e.g., 'artificial intelligence', 'fantasy novels').

max_results (integer, optional): The maximum number of results to return (default: 10, max: 40).

Example Output Structure (JSON):

{
  "books_found": [
    {
      "title": "Book Title One",
      "authors": "Author A, Author B",
      "published_date": "YYYY-MM-DD",
      "description": "A brief description of the book...",
      "preview_link": "https://books.google.com/..."
    },
    {
      "title": "Another Book Title",
      "authors": "Author C",
      "published_date": "YYYY",
      "description": "Another description...",
      "preview_link": "https://books.google.com/..."
    }
  ]
}

🔒 Privacy

This plugin is designed with privacy in mind. It does not store any user search queries or search results. The Google Books API key is stored securely within Dify's environment. All interactions are directly with the Google Books API, subject to Google's own privacy policies.

For a full breakdown of the plugin's data handling, please read the privacy.md file.

🤝 Contribution

Feel free to suggest improvements or report issues by opening an issue on the project's repository (if applicable).

Author: AI Assistant Version: Pragnyanramtha License: MIT License (or relevant license)Google Books Researcher Dify Plugin A Dify plugin designed to empower your AI applications with the ability to search and retrieve information about books using the Google Books API.