google

Documentation

Overview

Package google fetches Google/Gmail user profile data via OSINT methods.

This package supports:

• Gmail addresses: e.g., "user@gmail.com" or "mailto:user@gmail.com"
• GAIA IDs: e.g., "118127988220485054809" or Google Maps contrib URLs
• Google Maps contrib URLs: google.com/maps/contrib/{GAIA_ID}
• Album archive URLs: get.google.com/albumarchive/{GAIA_ID}

For Gmail addresses without a GAIA ID, the profile stores the email for future lookups. When a GAIA ID is available, it fetches public Maps data.

Index

• func AuthRequired() bool
• func Match(input string) bool
• type Client
  • func New(ctx context.Context, opts ...Option) (*Client, error)
  • func (c *Client) Fetch(ctx context.Context, input string) (*profile.Profile, error)
• type Option
  • func WithBrowserCookies() Option
  • func WithCookies(cookies map[string]string) Option
  • func WithHTTPCache(httpCache httpcache.Cacher) Option
  • func WithLogger(logger *slog.Logger) Option

Functions

func AuthRequired

func AuthRequired() bool

AuthRequired returns false because Maps lookups are public.

func Match

func Match(input string) bool

Match returns true if the input is a Gmail address, GAIA ID, or Google Maps contrib URL.

Types

type Client

type Client struct {
	// contains filtered or unexported fields
}

Client handles Google OSINT requests.

func New

func New(ctx context.Context, opts ...Option) (*Client, error)

New creates a Google OSINT client.

func (*Client) Fetch

func (c *Client) Fetch(ctx context.Context, input string) (*profile.Profile, error)

Fetch retrieves Google profile data from a Gmail address or GAIA ID.

type Option

type Option func(*config)

Option configures a Client.

func WithBrowserCookies

func WithBrowserCookies() Option

WithBrowserCookies enables reading cookies from browser stores.

func WithCookies

func WithCookies(cookies map[string]string) Option

WithCookies sets explicit cookie values.

func WithHTTPCache

func WithHTTPCache(httpCache httpcache.Cacher) Option

WithHTTPCache sets the HTTP cache.

func WithLogger

func WithLogger(logger *slog.Logger) Option

WithLogger sets a custom logger.