SuperAPI AI Directory

web-search

Writing & research

View repository

Updated 10-15 17:22

About this skill

Web Search

Available Tools

  • ddg_web_search(query, max_results=5): Search DuckDuckGo and return results with title, snippet, and link.
  • fetch_url_content(url, include_html=False, max_length=50000): Fetch a URL and extract clean text content.

Parameters

ddg_web_search

Parameter Type Default Description
query str (required) Search query string
max_results int 5 Number of results (max 10)

fetch_url_content

Parameter Type Default Description
url str (required) URL to fetch (must start with http:// or https://)
include_html bool False Include raw HTML in response
max_length int 50000 Maximum character length of extracted text

Usage Guidelines

  • Use specific, targeted search queries for best results
  • Set max_results to 3-5 for focused searches, up to 10 for broad research
  • Use fetch_url_content to read full page content from search result links
  • Break complex research into multiple targeted queries rather than one broad query
  • fetch_url_content automatically strips navigation, scripts, and boilerplate HTML
  • Reduce max_length for quick summaries or when you only need the beginning of a page

Citation Format

When presenting information from search results or fetched pages, wrap the relevant sentence or phrase itself in <cite> tags:

<cite source="SOURCE_TITLE" url="URL">claim text</cite>

Rules:

  • Cite factual claims, statistics, quotes, and specific information from search results.
  • The source attribute should contain the title or name of the source.
  • The url attribute should contain the source URL when available.
  • Do NOT cite your own reasoning or general knowledge.
  • If search results don't contain relevant information, inform the user rather than guessing.
  • Use the minimum number of citations necessary to support claims. The text inside <cite> is displayed as normal prose. Do not write a claim and then repeat it inside a citation. A short answer should remain short after citations are rendered.

Prices and interactive pages

For a price comparison, verify currency, per-person versus total cost, billing cadence, and any required commitment. A price shown as "per month" may be the monthly equivalent of an annual payment. Check billing selectors, official pricing FAQs, or another first-party source before concluding whether a commitment applies. If extracted text omits interactive controls, say the billing basis is unverified; do not claim the page has no condition. Use a browser tool when the condition cannot be resolved from fetched content. Preserve these qualifications in concise follow-up answers.