How to Get a Gemini API Key

This application uses AI models to read details from your collectible photos. To use it, you need to create a personal API key from Google. Here is how:

1. Go to Google AI Studio.
2. Sign in with any standard Google/Gmail account.
3. Click the blue "Create API Key" button in the top-left corner.
4. Select "Create API Key in new project".
5. Copy the generated key (starts with AIzaSy...).
6. Open **Settings** (gear icon) in this app, paste the key into the Gemini Key field, and click **Save Settings**.

How to Get a Google OAuth Client ID

To use the **Google Sign In** flow (which automatically generates OAuth tokens and connects to your Google Drive), you must configure a Google OAuth Client ID:

1. Go to the Google Cloud Console.
2. Create a new project or select an existing project.
3. Navigate to **APIs & Services** → **OAuth consent screen**:
   • Select **External** user type and click **Create**.
   • Fill in app details (App name, support email, developer email) and click **Save and Continue**.
   • Under **Scopes**, add the .../auth/drive and .../auth/userinfo.profile scopes.
   • Under **Test users**, add your own Gmail address (crucial while the app is in Testing mode).
4. Navigate to **APIs & Services** → **Credentials**:
   • Click **Create Credentials** → select **OAuth client ID**.
   • Set *Application type* to **Web application**.
   • Add **Authorized JavaScript origins**:
     http://localhost:8543 (and/or any host URL you are using).
   • Add **Authorized redirect URIs**:
     http://localhost:8543 (matching your server URL).
5. Click **Create** and copy the generated **Client ID** (ends in .apps.googleusercontent.com).
6. Paste it into the **Google OAuth Client ID** field in settings and click **Save Settings**.

How to Connect a Google Drive Shared Folder

You can load an entire folder of item photos or covers directly from Google Drive. To make this work, the folder must be publicly shared so the app can fetch the files client-side:

1. Upload your item covers or photos (.jpg, .png, or .webp) to a folder in Google Drive.
2. Right-click the folder (or tap the menu icon on mobile) and select Share → Share.
3. Under General Access, change Restricted to "Anyone with the link". Ensure the role is set to Viewer.
4. Click Copy Link and click Done.
5. Paste this link into the **Folder URL** field in this app, and click **Process Cloud Folder**.

How to Ingest folders from Dropbox

Web browsers block direct API downloads of Dropbox folders due to CORS security policies. You can easily process Dropbox folders using a 2-step download-and-drop workflow:

1. Open your shared Dropbox folder link in a browser tab.
2. Click the **Download** button in the top-right corner to download the entire folder as a single **ZIP file** to your machine.
3. Drag and drop that ZIP file directly into the **Drag & Drop Local Images or ZIP** dropzone in this app.
4. The app will automatically unpack the ZIP in memory and process your covers!

Google Drive Ingest Hosting Setup

When you ingest files from your local machine (via Drag & Drop or ZIP), the app can automatically upload them to your Google Drive and map them to your eBay CSV. Here is how to configure each credential:

1. Google API Key (Optional)

This is used to read shared cloud folder contents. To create one: Go to the Google Cloud Console → **APIs & Services** → **Credentials** → click **Create Credentials** → select **API Key**. Paste this into the Google API Key settings field.

2. Google Drive OAuth Access Token (Optional)

Google API Keys are read-only. To upload local files directly to your Drive, you need a temporary OAuth Access Token:

1. Go to the Google OAuth 2.0 Playground.
2. In the left panel under Step 1, scroll to **Drive API v3**.
3. Expand it and select https://www.googleapis.com/auth/drive scope (ticking the checkbox).
4. Click the blue **Authorize APIs** button and sign in with your Google account.
5. Under Step 2, click the **Exchange authorization code for tokens** button.
6. Copy the generated **Access Token** string (starts with ya29.) and paste it into the Settings field. (Note: Tokens expire after 1 hour).

3. Google Drive Upload Folder ID (Optional)

This is the folder where uploaded covers will be saved:

1. Create or open a folder in your Google Drive (e.g., named "Comic Ingests").
2. Copy the full folder link from your browser address bar. It will look like: https://drive.google.com/drive/folders/FOLDER_ID.
3. Paste this link into the **Upload Folder ID** Settings field. The app will automatically parse and extract the Folder ID when you click Save.

eBay Direct Connection Setup

Securely link your eBay account to upload batch images and create listings directly, bypassing third-party storage folders like Dropbox or Google Drive.

1. Connecting Your Account

1. Go to the **eBay Direct Connection** section in Settings.
2. Click the blue **"Connect Account"** button to open the secure consent popup.
3. Sign in to eBay and click **Agree** to authorize this application.
4. The popup will automatically close and link your profile. Your login sessions are fully encrypted and secured in the backend.

2. Direct Push Modes

Choose how pushed items are published under the **Direct Push Mode** dropdown:

• Push as Draft (Scheduled): Pushes listings to eBay but sets their start date 14 days in the future. They will appear inside your **Scheduled Listings** tab in the Seller Hub. You can edit, add description templates, and launch them whenever you like.
• Push as Active: Launches the listing live immediately on eBay as an active fixed-price listing.

3. Business Policies (Payment, Returns, Shipping)

If you have eBay Business Policies enabled:

1. Navigate to your eBay Account settings and look under **Business Policies**.
2. Copy the exact name of your preferred **Payment**, **Return**, and **Shipping** policies.
3. Paste them into their respective fields in the app Settings. The app will assign your policies automatically to all pushed items, saving you from setting up flat rates manually.

Shopify Direct Connection Setup

Securely connect your Shopify store to cross-list batch items directly as draft products on your e-commerce shop.

1. Generating Shopify Access Credentials

1. Log in to your Shopify Admin Panel (e.g. mystore.myshopify.com).
2. Navigate to **Settings** (bottom left) → **Apps and sales channels** → **Develop apps**.
3. Click **Create an app** and give it a name like "Comic Cataloger".
4. Go to the **Configuration** tab, click **Configure Admin API integration**, and enable **write_products** and **read_products** scopes.
5. Click **Save** and then click **Install app** at the top right.
6. Once installed, navigate to the **API credentials** tab and click **Reveal token once** under *Admin API access token*. Copy the token (starts with shpat_).

2. Connecting Your Store in the App

1. Open the Settings modal in Comic Cataloger.
2. Under **Shopify Direct Connection**, enter your **Shopify Store URL** (e.g., mystore.myshopify.com).
3. Paste your **Admin API Access Token** (the shpat_ token) in the Access Token field.
4. Click **Connect Store**. The app will securely encrypt and save these credentials in our database.