Kagi Search 🔍

A Rust library that allows you to perform Kagi searches programmatically using Playwright, without consuming additional API credits.

✨ Features

• 💳 No additional API credits required
• 🔐 Supports token-based, F2A-based and cookie-based authentication
• 🎭 Powered by Playwright for reliable web automation

📦 Installation

Add kagisearch to your Cargo.toml:

[dependencies]
kagisearch = "0.1.0"

🚀 Quick Start

use kagisearch::{AuthType, Browser};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // Initialize the browser with your Kagi token
    let browser = Browser::new(AuthType::Token("your_token_here".to_string())).await?;
    
    // Perform a search and get up to 5 results
    let results = browser.search("rust programming", 5).await?;
    
    // Print the results
    for result in results {
        println!("{:?}", result);
    }
    
    Ok(())
}

📖 Documentation

For more detailed examples and usage instructions, check out:

• Examples directory
• API Documentation

🤝 Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create a new branch for your feature
3. Submit a Pull Request

Please make sure to update tests as appropriate.

Credits

• playwright-rust
• google-search

⚖️ License

This project is licensed under the Apache License.

📝 Note

While Kagi is an excellent search engine, their API pricing can be cost-prohibitive. This library provides a way to integrate Kagi search functionality into your applications without incurring additional API costs beyond your Professional subscription.