phrona-api 0.1.1

REST API for the phrona library: search, suggestions, AI grounding, Tavily-compatible endpoint
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Phrona</title>
<meta name="description" content="Privacy-friendly metasearch across 26 engines.">
<link rel="stylesheet" href="/style.css">
</head>
<body>
<header class="topbar">
  <div class="topbar-inner">
    <span class="brand">Phrona</span>
    <nav class="tabs">
      <button class="tab active" data-view="search">Search</button>
      <button class="tab" data-view="tools">Tools</button>
    </nav>
    <span class="spacer"></span>
    <input id="api-key" class="text-input narrow" type="password" placeholder="API key" title="API key (sent as x-api-key)" autocomplete="off">
    <button id="theme-btn" class="icon-btn" title="Toggle theme" aria-label="Toggle theme"></button>
  </div>
</header>

<main>
  <!-- ===================== SEARCH ===================== -->
  <section id="view-search">
    <div class="hero">
      <div class="search-box">
        <div class="search-field">
          <input id="q" type="search" placeholder="Search the web, images, news, videos…" autocomplete="off" spellcheck="false">
          <button id="clear-btn" class="icon-btn" title="Clear" aria-label="Clear" hidden></button>
        </div>
        <div class="suggestions" id="suggestions" hidden></div>
      </div>
      <div class="category-row" id="category-row">
        <button class="chip active" data-cat="web">Web</button>
        <button class="chip" data-cat="images">Images</button>
        <button class="chip" data-cat="news">News</button>
        <button class="chip" data-cat="videos">Videos</button>
        <button class="chip" data-cat="books">Books</button>
      </div>
      <div class="param-row">
        <input id="region" class="text-input" placeholder="region (us-en)" autocomplete="off">
        <input id="language" class="text-input" placeholder="language (en)" autocomplete="off">
        <select id="time-range" class="select">
          <option value="">any time</option>
          <option value="day">past day</option>
          <option value="week">past week</option>
          <option value="month">past month</option>
          <option value="year">past year</option>
        </select>
        <select id="safesearch" class="select">
          <option value="off">safesearch off</option>
          <option value="moderate" selected>safesearch moderate</option>
          <option value="strict">safesearch strict</option>
        </select>
        <input id="max-results" class="text-input narrow" type="number" min="1" max="100" value="20" title="Max results">
        <input id="page" class="text-input narrow" type="number" min="1" value="1" title="Page">
        <input id="filters" class="text-input grow" placeholder="filters — e.g. site:github.com" autocomplete="off">
      </div>
      <div class="engines-row" id="engines-row"></div>
      <div class="actions">
        <button id="search-btn" class="raised-btn">Search</button>
        <label class="check"><input id="suggest-toggle" type="checkbox" checked>suggestions</label>
        <label class="check"><input id="json-toggle" type="checkbox">JSON</label>
      </div>
    </div>

    <div class="meta" id="meta" hidden></div>
    <div class="answer" id="answer" hidden></div>
    <div class="results" id="results"></div>
    <div class="empty" id="empty" hidden><p>Type a query and press Search.</p></div>
    <div class="pager" id="pager" hidden>
      <button id="prev-btn" class="raised-btn small">‹ prev</button>
      <span class="pager-info" id="pager-info"></span>
      <button id="next-btn" class="raised-btn small">next ›</button>
    </div>
    <div class="engine-report" id="engine-report" hidden>
      <button id="report-toggle" class="report-head">Engine report <span id="report-caret">▸</span></button>
      <div id="report-body" class="report-body" hidden></div>
    </div>
  </section>

  <!-- ===================== TOOLS ===================== -->
  <section id="view-tools" hidden>
    <h1 class="page-title">Tools</h1>
    <p class="page-sub">The same operations as the <code>ms</code> CLI, in the browser — against the live API.</p>
    <nav class="tabs tool-tabs" id="tool-tabs">
      <button class="tab active" data-tool="suggest">suggest</button>
      <button class="tab" data-tool="extract">extract</button>
      <button class="tab" data-tool="ground">ground</button>
      <button class="tab" data-tool="engines">engines</button>
      <button class="tab" data-tool="test">test</button>
    </nav>

    <div class="tool-panel" id="tool-suggest">
      <form class="tool-form" data-tool-form="suggest">
        <input class="text-input grow" placeholder="query prefix" required data-f="q">
        <select class="select" data-f="source">
          <option value="">all sources</option>
          <option>duckduckgo</option><option>google</option><option>bing</option>
          <option>brave</option><option>startpage</option><option>qwant</option><option>wikipedia</option>
        </select>
        <input class="text-input" placeholder="region (us-en)" data-f="region">
        <button class="raised-btn small">Run</button>
        <label class="check"><input type="checkbox" class="json-check">JSON</label>
      </form>
      <div class="out" data-out="suggest"></div>
    </div>

    <div class="tool-panel" id="tool-extract" hidden>
      <form class="tool-form" data-tool-form="extract">
        <input class="text-input grow" placeholder="https://…" required data-f="url">
        <input class="text-input narrow" type="number" min="1" value="5000" title="max chars" data-f="max_chars">
        <input class="text-input" placeholder="bias query (optional)" data-f="query">
        <button class="raised-btn small">Run</button>
        <label class="check"><input type="checkbox" class="json-check">JSON</label>
      </form>
      <div class="out" data-out="extract"></div>
    </div>

    <div class="tool-panel" id="tool-ground" hidden>
      <form class="tool-form" data-tool-form="ground">
        <input class="text-input grow" placeholder="query" required data-f="query">
        <input class="text-input narrow" type="number" min="1" max="50" value="8" title="max results" data-f="max_results">
        <select class="select" data-f="category">
          <option value="web">web</option><option value="images">images</option>
          <option value="news">news</option><option value="videos">videos</option>
          <option value="books">books</option>
        </select>
        <select class="select" data-f="time_range">
          <option value="">any time</option>
          <option value="day">past day</option><option value="week">past week</option>
          <option value="month">past month</option><option value="year">past year</option>
        </select>
        <button class="raised-btn small">Run</button>
        <label class="check"><input type="checkbox" class="json-check">JSON</label>
      </form>
      <div class="out" data-out="ground"></div>
    </div>

    <div class="tool-panel" id="tool-engines" hidden>
      <form class="tool-form" data-tool-form="engines">
        <select class="select" data-f="category">
          <option value="">all categories</option>
          <option value="web">web</option><option value="images">images</option>
          <option value="news">news</option><option value="videos">videos</option>
          <option value="books">books</option>
        </select>
        <button class="raised-btn small">Run</button>
        <label class="check"><input type="checkbox" class="json-check">JSON</label>
      </form>
      <div class="out" data-out="engines"></div>
    </div>

    <div class="tool-panel" id="tool-test" hidden>
      <form class="tool-form" data-tool-form="test">
        <input class="text-input grow" placeholder="query (default: rust programming)" data-f="query">
        <select class="select" data-f="category">
          <option value="">all categories</option>
          <option value="web">web</option><option value="images">images</option>
          <option value="news">news</option><option value="videos">videos</option>
          <option value="books">books</option>
        </select>
        <input class="text-input narrow" type="number" min="1" max="10" value="5" title="max results" data-f="max_results">
        <button class="raised-btn small">Run</button>
        <label class="check"><input type="checkbox" class="json-check">JSON</label>
      </form>
      <div class="out" data-out="test"></div>
    </div>
  </section>
</main>

<footer class="foot">Powered by Phrona — requests are routed through multiple engines and merged locally.</footer>
<script src="/app.js"></script>
</body>
</html>