feat(tools): added similarweb

[waleedlatif1]

Summary

• added similarweb

Type of Change

• New Feature

Testing

tested manually

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jan 30, 2026 4:41am

[greptile-apps]

Greptile Overview

Greptile Summary

This PR adds a comprehensive Similarweb integration to the platform, enabling users to fetch website analytics data including traffic estimates, engagement metrics, rankings, and traffic sources.

Implementation highlights:

• 5 tool endpoints: website overview, traffic visits, bounce rate, pages per visit, and visit duration
• Robust API handling: Flexible response parsing handles both PascalCase and snake_case from Similarweb API
• User-friendly block config: Conditional fields, AI-powered date inputs with wandConfig, and comprehensive country/granularity options
• Proper credential handling: API key uses user-only visibility per project standards
• Complete documentation: Well-structured MDX documentation with all parameters and outputs

Code quality:

• Follows established patterns from similar integrations (Ahrefs, Apollo)
• Consistent TypeScript typing across all tools
• Proper error handling with informative messages
• DRY principle applied with shared types and utilities

Side changes:

• Removed deprecated youtube_captions tool documentation (unrelated cleanup)

The implementation is production-ready with no critical issues found.

Confidence Score: 5/5

• Safe to merge - well-structured implementation following established patterns
• Clean implementation with proper error handling, correct credential visibility, comprehensive documentation, and consistent patterns. No security issues, logic errors, or architectural concerns.
• No files require special attention

Important Files Changed

Filename	Overview
apps/sim/tools/similarweb/website_overview.ts	Implements comprehensive website overview endpoint with proper error handling and flexible response parsing
apps/sim/tools/similarweb/traffic_visits.ts	Time-series visits data endpoint with proper parameter handling and consistent structure
apps/sim/tools/similarweb/types.ts	Well-structured TypeScript types for all Similarweb API endpoints
apps/sim/blocks/blocks/similarweb.ts	Comprehensive block configuration with conditional fields and AI-powered date inputs
apps/sim/tools/registry.ts	Added all 5 Similarweb tools to the registry
apps/docs/content/docs/en/tools/similarweb.mdx	Comprehensive documentation for all Similarweb tools and endpoints

Sequence Diagram

sequenceDiagram
    participant User
    participant Block as SimilarwebBlock
    participant Tool as Similarweb Tool
    participant API as Similarweb API
    
    User->>Block: Configure operation & parameters
    Note over Block: Operation: website_overview,<br/>traffic_visits, bounce_rate,<br/>pages_per_visit, visit_duration
    Block->>Block: Validate inputs (domain, apiKey)
    Block->>Tool: Route to selected tool
    
    alt Website Overview
        Tool->>API: GET /v1/website/{domain}/general-data/all
        API-->>Tool: Traffic, rankings, engagement data
        Tool->>Tool: Transform response (handle both PascalCase & snake_case)
        Tool-->>Block: Return overview with topCountries, trafficSources
    else Time-Series Tools
        Tool->>API: GET /v1/website/{domain}/total-traffic-and-engagement/*
        Note over API: Endpoints: visits, bounce-rate,<br/>pages-per-visit, average-visit-duration
        API-->>Tool: Time-series data with metadata
        Tool->>Tool: Transform to consistent format
        Tool-->>Block: Return array of time-series data points
    end
    
    Block-->>User: Display results with all outputs

Loading

[greptile-apps]

_{6 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}