Gemini Search

• Features
• Getting a Gemini API Key
  • Step 1: Create a Google AI Studio Account
  • Step 2: Generate an API Key
  • Step 3: Free vs Paid Plan
  • Step 4: Enable the API
• Installation
• Configuration
  • Disable page or widget
• Use Cases
  • 1. Price Monitoring / Comparison
  • 2. Competitive Intelligence
  • 3. Supplier Research
  • 4. Enhanced Customer Support
  • 5. Regulatory / Legal Research
  • 6. Tech Watch
• How It Works (Under the Hood)
• Available Gemini Models
• Testing
  • Quick Test (without Laravel)
  • Test in Laravel (Tinker)
• License

A Filament v4/v5 plugin that integrates Google Gemini API with Google Search Grounding to perform real-time web searches directly from your admin panel.

Gemini doesn't just generate text — it performs real Google searches, analyzes the results, and returns structured responses with verifiable sources.

#Features

• Real-time web search via Gemini + Google Search Grounding
• Dedicated search page with Markdown result rendering
• Compact dashboard widget
• Clickable sources and links to found websites
• Search history stored in database
• Multi-language support (EN/FR)
• Full dark mode support
• Compatible with Filament v4 and v5

#Getting a Gemini API Key

#Step 1: Create a Google AI Studio Account

1. Go to Google AI Studio
2. Sign in with your Google account

#Step 2: Generate an API Key

1. Click "Get API Key" in the left menu
2. Click "Create API Key"
3. Select a Google Cloud project (or create one)
4. Copy the generated key (format: AIzaSy...)

#Step 3: Free vs Paid Plan

Tip: The free plan is more than enough for development and moderate production use. To enable billing, visit Google Cloud Console > Billing.

#Step 4: Enable the API

If you encounter 403 errors, enable the API manually:

1. Go to Google Cloud Console > APIs
2. Search for "Generative Language API"
3. Click "Enable"

#Installation

composer require akpagni5547/filament-gemini-search

Add your key to .env:

GEMINI_API_KEY=AIzaSy...your-key-here
GEMINI_MODEL=gemini-2.5-flash

Publish the configuration and run migrations:

php artisan vendor:publish --tag=gemini-search-config
php artisan migrate

Register the plugin in your PanelProvider:

use SelfProject\FilamentGeminiSearch\FilamentGeminiSearchPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(FilamentGeminiSearchPlugin::make());
}

#Configuration

// config/gemini-search.php

return [
    'api_key' => env('GEMINI_API_KEY'),
    'model' => env('GEMINI_MODEL', 'gemini-2.5-flash'),
    'grounding' => [
        'enabled' => true, // Enable Google Search Grounding
    ],
    'history' => [
        'enabled' => true,  // Save searches in DB
        'max_records' => 500,
    ],
    'navigation' => [
        'group' => null,         // Filament navigation group
        'icon' => 'heroicon-o-magnifying-glass',
        'sort' => 100,
    ],
];

#Disable page or widget

FilamentGeminiSearchPlugin::make()
    ->disablePage()    // Keep only the widget
    ->disableWidget()  // Keep only the page

#Use Cases

#1. Price Monitoring / Comparison

Search for product prices across different e-commerce sites. Gemini performs the Google search and returns prices with links to stores.

"iPhone 16 Pro price comparison 2026"

Result: Price list with links to Amazon, Best Buy, etc.

#2. Competitive Intelligence

Monitor what your competitors are doing, their offers, and latest news.

"Latest AWS pricing changes cloud computing March 2026"

Result: Summary of current offers with official sources.

#3. Supplier Research

Find suppliers for your business needs directly from your back-office.

"Best wholesale office supplies distributors with delivery"

Result: List of suppliers with contacts and websites.

#4. Enhanced Customer Support

Your support agents can search for product information in real-time to assist customers.

"Samsung Galaxy A15 full technical specifications"

Result: Detailed specifications with reliable sources.

#5. Regulatory / Legal Research

Find information about current regulations.

"GDPR compliance requirements for SaaS companies 2026"

Result: Steps and required documents with official links.

#6. Tech Watch

Stay informed about the latest tech trends from your admin dashboard.

"Laravel 12 new features and improvements"

Result: Summary of new features with links to official docs.

#How It Works (Under the Hood)

+--------------+     +--------------+     +--------------+
| Filament UI  |---->| Gemini API   |---->| Google Search|
| (your app)   |     | (LLM)        |     | (grounding)  |
+--------------+     +------+-------+     +--------------+
                            |
                    +-------v-------+
                    | Response with |
                    | - AI text     |
                    | - Web sources |
                    | - Queries     |
                    +---------------+

The key is the tools: [{ google_search: {} }] parameter in the API call. This tells Gemini: "Before answering, perform a real Google search and base your response on the results."

#Available Gemini Models

Recommended: gemini-2.5-flash — best speed/quality ratio.

#Testing

#Quick Test (without Laravel)

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [{"parts": [{"text": "Latest Laravel features"}]}],
    "tools": [{"google_search": {}}]
  }'

#Test in Laravel (Tinker)

php artisan tinker

$service = app(\SelfProject\FilamentGeminiSearch\Services\GeminiSearchService::class);
$result = $service->search('Latest Laravel 12 features');

echo $result->text;           // Formatted response
dump($result->sources);       // Sources with URLs
dump($result->searchQueries); // Google queries performed

#License

MIT