<?xml version="1.0" encoding="UTF-8"?>
<agent-document format="zappian-agent-view" version="1" kind="search" path="/search/">
  <title>Search</title>
  <summary>Search every page and article of Zappian Media.</summary>
  <urls human="https://staging.zappian.in/agent/search/" agent="https://staging.zappian.in/agent/search/" markdown="https://staging.zappian.in/agent/search.md" json="https://staging.zappian.in/agent/search.json">
    <formats md="https://staging.zappian.in/agent/search.md" json="https://staging.zappian.in/agent/search.json" xml="https://staging.zappian.in/agent/search.xml" toon="https://staging.zappian.in/agent/search.toon"/>
  </urls>
  <generated>2026-11-19T10:36:41Z</generated>
  <sections>
    <section id="how" title="How to search">
      <heading level="3">Parameters</heading>
      <list ordered="false">
        <item>q: the words to look for, 2 to 200 characters.</item>
        <item>kind: one kind of page, or any. One of any, brief, page, article, legal, index, news. Default any.</item>
        <item>limit: how many results to return, 1 to 20. Default 10.</item>
      </list>
      <heading level="3">Order of results</heading>
      <list ordered="false">
        <item>Each page is searched by its title, summary, headings and text, without case, accents or punctuation.</item>
        <item>A query word also finds longer words that start with it, so loan finds loans.</item>
        <item>Words on more than half of the pages count only for order when a rarer query word appears on some page.</item>
        <item>Pages with more of your words come first. Then a word in the title counts most, then the summary, a heading and the text.</item>
        <item>The whole query as a phrase counts more than the same words apart.</item>
      </list>
      <paragraph>The same search is a raw file in four formats: add .md, .json, .xml or .toon to /agent/search and keep the query.</paragraph>
      <paragraph>The search tool of the MCP server takes the same input: query, kind and limit.</paragraph>
    </section>
  </sections>
  <entries count="0"/>
</agent-document>
