Vibe.Plugins.WebSearch (vibe v0.2.1)

Web search plugin and provider-neutral eval API exposed as Web.

Summary

Types

fetch_result()

search_result()

Functions

fetch(url, opts \\ [])

Fetches a URL through the configured fetch provider.

fetch!(url, opts \\ [])

Raises on URL fetch errors.

filter_domain(search, domain)

Filters search results to URLs containing a domain substring.

parse_html(value)

Parses HTML from a fetch result or binary string with Floki.

parse_html!(value)

Parses HTML from a fetch result or binary string with Floki, raising on failure.

search(query, opts \\ [])

Searches the web through the configured search provider.

search!(query, opts \\ [])

Raises on web search errors.

select(result, selector)

Extracts matching HTML from a fetched page with a CSS selector.

select!(result, selector)

Extracts matching HTML from a fetched page with a CSS selector, raising on failure.

take(search, count)

Keeps at most count search results.

truncate(value, opts \\ [])

Truncates fetched content or plain text using the shared tool-output byte limit.

Types

fetch_result()

@type fetch_result() :: Vibe.Plugins.WebSearch.FetchResult.t()

search_result()

@type search_result() :: Vibe.Plugins.WebSearch.SearchResult.t()

Functions

fetch(url, opts \\ [])

@spec fetch(
  String.t(),
  keyword()
) :: {:ok, Vibe.Plugins.WebSearch.FetchResult.t()} | {:error, term()}

Fetches a URL through the configured fetch provider.

fetch!(url, opts \\ [])

@spec fetch!(
  String.t(),
  keyword()
) :: Vibe.Plugins.WebSearch.FetchResult.t()

Raises on URL fetch errors.

filter_domain(search, domain)

@spec filter_domain(
  {:ok, Vibe.Plugins.WebSearch.SearchResult.t()}
  | Vibe.Plugins.WebSearch.SearchResult.t(),
  String.t()
) ::
  {:ok, Vibe.Plugins.WebSearch.SearchResult.t()}
  | Vibe.Plugins.WebSearch.SearchResult.t()

Filters search results to URLs containing a domain substring.

parse_html(value)

@spec parse_html(Vibe.Plugins.WebSearch.FetchResult.t() | String.t()) ::
  {:ok, Vibe.Plugins.WebSearch.HTML.html_tree()} | {:error, term()}

Parses HTML from a fetch result or binary string with Floki.

parse_html!(value)

@spec parse_html!(Vibe.Plugins.WebSearch.FetchResult.t() | String.t()) ::
  Vibe.Plugins.WebSearch.HTML.html_tree()

Parses HTML from a fetch result or binary string with Floki, raising on failure.

search(query, opts \\ [])

@spec search(
  String.t(),
  keyword()
) :: {:ok, Vibe.Plugins.WebSearch.SearchResult.t()} | {:error, term()}

Searches the web through the configured search provider.

search!(query, opts \\ [])

@spec search!(
  String.t(),
  keyword()
) :: Vibe.Plugins.WebSearch.SearchResult.t()

Raises on web search errors.

select(result, selector)

@spec select(Vibe.Plugins.WebSearch.FetchResult.t(), String.t()) ::
  {:ok, Vibe.Plugins.WebSearch.FetchResult.t()} | {:error, term()}

Extracts matching HTML from a fetched page with a CSS selector.

select!(result, selector)

@spec select!(Vibe.Plugins.WebSearch.FetchResult.t(), String.t()) ::
  Vibe.Plugins.WebSearch.FetchResult.t()

Extracts matching HTML from a fetched page with a CSS selector, raising on failure.

take(search, count)

@spec take(
  {:ok, Vibe.Plugins.WebSearch.SearchResult.t()}
  | Vibe.Plugins.WebSearch.SearchResult.t(),
  non_neg_integer()
) ::
  {:ok, Vibe.Plugins.WebSearch.SearchResult.t()}
  | Vibe.Plugins.WebSearch.SearchResult.t()

Keeps at most count search results.

truncate(value, opts \\ [])

@spec truncate(Vibe.Plugins.WebSearch.FetchResult.t(), keyword() | pos_integer()) ::
  Vibe.Plugins.WebSearch.FetchResult.t()

@spec truncate(String.t(), keyword() | pos_integer()) :: String.t()

Truncates fetched content or plain text using the shared tool-output byte limit.