sylva.handler

sylva.handler.Handler

Handler()

Request handler with built-in helpers and proxy services

Attributes:

Name	Type	Description
`collector`	`Collector`	Collector object to store results
`runners`	`List[Runner]`	List of search modules to execute queries

Executing a simple string-based search

from sylva.handler import Handler

handler = Handler()
handler.branch_all('username')
results = handler.collector.get_data() # Returns a DataFrame

print(results)

Executing a search using a QueryDataItem

from sylva.handler import Handler, QueryDataItem
from sylva.helpers.generic import QueryType

handler = Handler()

query = QueryDataItem(query='username', type=QueryType.USERNAME)
handler.branch_all(query)
results = handler.collector.get_data() # Returns a DataFrame

print(results)

__prepare_flaresolverr

__prepare_flaresolverr()

Attempt to start the proxy service and a common browser session

branch_all

branch_all(query, depth=1, no_deduplicate=False)

Recursively search all available modules for the given query

Runs a variable-depth search for a given query across all available modules and integrations, automatically deduplicating the results. Results are added to the object's collector.

Parameters:

Name	Type	Description	Default
`query`	`str`	The query to search for	required
`depth`	`int`	The depth to search. Defaults to 1.	`1`
`no_deduplicate`	`bool`	Skip deduplication for manual processing. Defaults to False.	`False`

search_all

search_all(query, no_deduplicate=False)

Search all available modules for the given query

Runs a single-depth search for a given query across all available modules and integrations, automatically deduplicating the results. Results are added to the object's collector.

Parameters:

Name	Type	Description	Default
`query`	`str \| QueryDataItem`	The query to search for	required
`no_deduplicate`	`bool`	Skip deduplication for manual processing. Defaults to False.	`False`

Returns:

Name	Type	Description
`int`	`int`	The number of identities discovered