tooluniverse.fatcat_tool module

class tooluniverse.fatcat_tool.FatcatResultParser

Bases: HTMLParser

Parse Fatcat search results from HTML.

__init__()

Initialize and reset this instance.

If convert_charrefs is true (the default), all character references are automatically converted to the corresponding Unicode characters.

If scripting is false (the default), the content of the noscript element is parsed normally; if it’s true, it’s returned as is without being parsed.

handle_starttag(tag, attrs)

handle_data(data)

handle_endtag(tag)

class tooluniverse.fatcat_tool.FatcatMetadataParser

Bases: HTMLParser

Extract metadata from Fatcat release page meta tags.

__init__()

Initialize and reset this instance.

If convert_charrefs is true (the default), all character references are automatically converted to the corresponding Unicode characters.

If scripting is false (the default), the content of the noscript element is parsed normally; if it’s true, it’s returned as is without being parsed.

handle_starttag(tag, attrs)

class tooluniverse.fatcat_tool.FatcatScholarTool

Bases: BaseTool

Search Internet Archive Scholar via Fatcat releases search.

Uses web scraping of the scholar.archive.org interface to retrieve bibliographic information about research papers and publications.

Parameters (arguments):

query (str): Query string max_results (int): Max results (default 10, max 100)

__init__(tool_config)

run(arguments=None)

Execute the tool.

The default BaseTool implementation accepts an optional arguments mapping to align with most concrete tool implementations which expect a dictionary of inputs.

Parameters:

• arguments (dict, optional) – Tool-specific arguments

• stream_callback (callable, optional) – Callback for streaming responses

• use_cache (bool, optional) – Whether result caching is enabled

• validate (bool, optional) – Whether parameter validation was performed

Note

These additional parameters (stream_callback, use_cache, validate) are passed from run_one_function() to provide context about the execution. Tools can use these for optimization or special handling.

For backward compatibility, tools that don’t accept these parameters will still work - they will only receive the arguments parameter.