AI Pinterest Bulk Pin Generator

This application is a powerful tool for content creators and bloggers that leverages Artificial Intelligence (Google Gemini 2.5 Flash and Imagen 4/Flash Image) to automatically generate attractive Pinterest pins from your blog posts.

The app generates titles, descriptions, SEO keywords, and creates visually appealing images. Results can be saved directly to Google Drive and downloaded as a CSV ready for Pinterest bulk upload.

✨ Key Features

• Content Analysis: Paste your blog text, and the AI suggests relevant pin concepts.
• Image Generation: Creates unique images using Imagen 4.0 (High Quality) or Gemini 2.5 Flash Image (Cost Effective).
• Pinterest Optimization: Automatically formats images to 2:3 or 3:4 aspect ratios.
• Google Drive Integration: Automatically creates folders, uploads images, and generates public viewing links.
• Bulk Export: Generates a CSV file formatted exactly for the Pinterest Bulk Upload tool.
• Profile Management: Save settings for multiple blogs or clients.

🛠️ Prerequisites

Before you begin, you will need:

1. Node.js (Version 18 or later).
2. Google Gemini API Key (Get it from Google AI Studio).
3. Google Cloud Project (For Google Drive integration - see Configuration section).

🚀 Installation and Setup

1. Clone the repository:

   git clone https://github.com/your-username/repo-name.git
   cd repo-name

2. Install dependencies:

   npm install
   # or
   yarn install

3. Environment Setup: Create a .env file in the root directory and add your Gemini API Key:

   API_KEY=your_gemini_api_key_here

   Note: This file is ignored by Git to keep your key secure.

4. Start the application:

   npm start
   # or the command defined in your package.json (e.g., npm run dev)

⚙️ Google Drive Configuration (OAuth)

To allow the app to save files to your Google Drive, you need to create an "OAuth Client ID":

1. Go to the Google Cloud Console.
2. Create a new project or select an existing one.
3. Go to APIs & Services > Enabled APIs and enable the Google Drive API.
4. Go to OAuth consent screen and configure the app (for personal use, select "External" and add your email to "Test users").
5. Go to Credentials, click Create Credentials, and select OAuth Client ID -> Web application.
6. Under "Authorized JavaScript origins", add the URL where the app is running (e.g., http://localhost:3000).
7. Copy the generated Client ID.
8. In the application, click the settings icon (or "Sign in") and paste this Client ID.

🔒 Security

• API Keys: Never upload your .env file to GitHub. The .gitignore file in this project is already configured to exclude it.
• Client ID: The Google Client ID is stored locally in your browser (localStorage) and communicates directly with Google servers.

📄 License

This project is provided as-is.