NTab仓库
fjmwkj
/
searxng
mirror of https://github.com/searxng/searxng
1
0
Fork 0
Files Issues 0 Wiki
Branch: gh-pages
Branches Tags
searxng
/
dev
/
plugins
/
development.html

development.html 49 KB
Permalink History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429 
  1. <!DOCTYPE html>
    2. 

  2. 

  3. <html lang="en" data-content_root="../../">
    4. 

  4.   <head>
    5. 

  5.     <meta charset="utf-8" />
    6. 

  6.     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    7. 

  7.   <meta name="viewport" content="width=device-width, initial-scale=1">
    8. 

  8.     <title>Plugin Development &#8212; SearXNG Documentation (2025.8.3+2e62eb5d6)</title>
    9. 

  9.     <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=6625fa76" />
    10. 

  10.     <link rel="stylesheet" type="text/css" href="../../_static/searxng.css?v=52e4ff28" />
    11. 

  11.     <script src="../../_static/documentation_options.js?v=f5eb0a7b"></script>
    12. 

  12.     <script src="../../_static/doctools.js?v=9a2dae69"></script>
    13. 

  13.     <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
    14. 

  14.     <script data-project="searxng" data-version="2025.8.3+2e62eb5d6" src="../../_static/describe_version.js?v=fa7f30d0"></script>
    15. 

  15.     <link rel="index" title="Index" href="../../genindex.html" />
    16. 

  16.     <link rel="search" title="Search" href="../../search.html" />
    17. 

  17.     <link rel="next" title="Built-in Plugins" href="builtins.html" />
    18. 

  18.     <link rel="prev" title="Plugins" href="index.html" /> 
    19. 

  19.   </head><body>
    20. 

  20.     <div class="related" role="navigation" aria-label="Related">
    21. 

  21.       <h3>Navigation</h3>
    22. 

  22.       <ul>
    23. 

  23.         <li class="right" style="margin-right: 10px">
    24. 

  24.           <a href="../../genindex.html" title="General Index"
    25. 

  25.              accesskey="I">index</a></li>
    26. 

  26.         <li class="right" >
    27. 

  27.           <a href="../../py-modindex.html" title="Python Module Index"
    28. 

  28.              >modules</a> |</li>
    29. 

  29.         <li class="right" >
    30. 

  30.           <a href="builtins.html" title="Built-in Plugins"
    31. 

  31.              accesskey="N">next</a> |</li>
    32. 

  32.         <li class="right" >
    33. 

  33.           <a href="index.html" title="Plugins"
    34. 

  34.              accesskey="P">previous</a> |</li>
    35. 

  35.         <li class="nav-item nav-item-0"><a href="../../index.html">SearXNG Documentation (2025.8.3+2e62eb5d6)</a> &#187;</li>
    36. 

  36.           <li class="nav-item nav-item-1"><a href="../index.html" >Developer documentation</a> &#187;</li>
    37. 

  37.           <li class="nav-item nav-item-2"><a href="index.html" accesskey="U">Plugins</a> &#187;</li>
    38. 

  38.         <li class="nav-item nav-item-this"><a href="">Plugin Development</a></li> 
    39. 

  39.       </ul>
    40. 

  40.     </div>  
    41. 

  41. 

  42.     <div class="document">
    43. 

  43.       <div class="documentwrapper">
    44. 

  44.         <div class="bodywrapper">
    45. 

  45.           <div class="body" role="main">
    46. 

  46.             
    47. 

  47.   <section id="module-searx.plugins">
    48. 

  48. <span id="plugin-development"></span><span id="dev-plugin"></span><h1>Plugin Development<a class="headerlink" href="#module-searx.plugins" title="Link to this heading">¶</a></h1>
    49. 

  49. <aside class="sidebar">
    50. 

  50. <p class="sidebar-title">Further reading ..</p>
    51. 

  51. <ul class="simple">
    52. 

  52. <li><p><a class="reference internal" href="../../admin/plugins.html#plugins-admin"><span class="std std-ref">List of plugins</span></a></p></li>
    53. 

  53. <li><p><a class="reference internal" href="../../admin/settings/settings_plugins.html#settings-plugins"><span class="std std-ref">SearXNG settings</span></a></p></li>
    54. 

  54. </ul>
    55. 

  55. </aside>
    56. 

  56. <p>Plugins can extend or replace functionality of various components of SearXNG.</p>
    57. 

  57. <p>Entry points (hooks) define when a plugin runs.  Right now only three hooks are
    58. 

  58. implemented.  So feel free to implement a hook if it fits the behaviour of your
    59. 

  59. plugin / a plugin doesn’t need to implement all the hooks.</p>
    60. 

  60. <ul class="simple">
    61. 

  61. <li><p>pre search: <a class="reference internal" href="#searx.plugins.Plugin.pre_search" title="searx.plugins.Plugin.pre_search"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Plugin.pre_search</span></code></a></p></li>
    62. 

  62. <li><p>post search: <a class="reference internal" href="#searx.plugins.Plugin.post_search" title="searx.plugins.Plugin.post_search"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Plugin.post_search</span></code></a></p></li>
    63. 

  63. <li><p>on each result item: <a class="reference internal" href="#searx.plugins.Plugin.on_result" title="searx.plugins.Plugin.on_result"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Plugin.on_result</span></code></a></p></li>
    64. 

  64. </ul>
    65. 

  65. <p>Below you will find some examples, for more coding examples have a look at the
    66. 

  66. built-in plugins <a class="extlink-origin reference external" href="https://github.com/searxng/searxng/blob/master/searx/plugins/">git://searx/plugins/</a> or <a class="reference external" href="https://github.com/return42/tgwf-searx-plugins/">Only show green hosted results</a>.</p>
    67. 

  67. <section id="add-answer-example">
    68. 

  68. <h2>Add Answer example<a class="headerlink" href="#add-answer-example" title="Link to this heading">¶</a></h2>
    69. 

  69. <p>Here is an example of a very simple plugin that adds a “Hello World” into the
    70. 

  70. answer area:</p>
    71. 

  71. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">flask_babel</span><span class="w"> </span><span class="kn">import</span> <span class="n">gettext</span> <span class="k">as</span> <span class="n">_</span>
    72. 

  72. <span class="kn">from</span><span class="w"> </span><span class="nn">searx.plugins</span><span class="w"> </span><span class="kn">import</span> <span class="n">Plugin</span>
    73. 

  73. <span class="kn">from</span><span class="w"> </span><span class="nn">searx.result_types</span><span class="w"> </span><span class="kn">import</span> <span class="n">Answer</span>
    74. 

  74. 

  75. <span class="k">class</span><span class="w"> </span><span class="nc">MyPlugin</span><span class="p">(</span><span class="n">Plugin</span><span class="p">):</span>
    76. 

  76. 

  77.     <span class="nb">id</span> <span class="o">=</span> <span class="s2">&quot;hello world&quot;</span>
    78. 

  78. 

  79.     <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">plg_cfg</span><span class="p">):</span>
    80. 

  80.         <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="n">plg_cfg</span><span class="p">)</span>
    81. 

  81.         <span class="bp">self</span><span class="o">.</span><span class="n">info</span> <span class="o">=</span> <span class="n">PluginInfo</span><span class="p">(</span><span class="nb">id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">id</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="n">_</span><span class="p">(</span><span class="s2">&quot;Hello&quot;</span><span class="p">),</span> <span class="n">description</span><span class="o">=</span><span class="n">_</span><span class="p">(</span><span class="s2">&quot;demo plugin&quot;</span><span class="p">))</span>
    82. 

  82. 

  83.     <span class="k">def</span><span class="w"> </span><span class="nf">post_search</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">,</span> <span class="n">search</span><span class="p">):</span>
    84. 

  84.         <span class="k">return</span> <span class="p">[</span> <span class="n">Answer</span><span class="p">(</span><span class="n">answer</span><span class="o">=</span><span class="s2">&quot;Hello World&quot;</span><span class="p">)</span> <span class="p">]</span>
    85. 

  85. </pre></div>
    86. 

  86. </div>
    87. 

  87. </section>
    88. 

  88. <section id="filter-urls-example">
    89. 

  89. <span id="id1"></span><h2>Filter URLs example<a class="headerlink" href="#filter-urls-example" title="Link to this heading">¶</a></h2>
    90. 

  90. <aside class="sidebar">
    91. 

  91. <p class="sidebar-title">Further reading ..</p>
    92. 

  92. <ul class="simple">
    93. 

  93. <li><p><a class="reference internal" href="../result_types/base_result.html#searx.result_types._base.Result.filter_urls" title="searx.result_types._base.Result.filter_urls"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Result.filter_urls(..)</span></code></a></p></li>
    94. 

  94. </ul>
    95. 

  95. </aside>
    96. 

  96. <p>The <a class="reference internal" href="../result_types/base_result.html#searx.result_types._base.Result.filter_urls" title="searx.result_types._base.Result.filter_urls"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Result.filter_urls(..)</span></code></a>
    97. 

  97. can be used to filter and/or modify URL fields.  In the following example, the
    98. 

  98. filter function <code class="docutils literal notranslate"><span class="pre">my_url_filter</span></code>:</p>
    99. 

  99. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">def</span><span class="w"> </span><span class="nf">my_url_filter</span><span class="p">(</span><span class="n">result</span><span class="p">,</span> <span class="n">field_name</span><span class="p">,</span> <span class="n">url_src</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span> <span class="o">|</span> <span class="nb">str</span><span class="p">:</span>
    100. 

  100.     <span class="k">if</span> <span class="s2">&quot;google&quot;</span> <span class="ow">in</span> <span class="n">url_src</span><span class="p">:</span>
    101. 

  101.         <span class="k">return</span> <span class="kc">False</span>              <span class="c1"># remove URL field from result</span>
    102. 

  102.     <span class="k">if</span> <span class="s2">&quot;facebook&quot;</span> <span class="ow">in</span> <span class="n">url_src</span><span class="p">:</span>
    103. 

  103.         <span class="n">new_url</span> <span class="o">=</span> <span class="n">url_src</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s2">&quot;facebook&quot;</span><span class="p">,</span> <span class="s2">&quot;fb-dummy&quot;</span><span class="p">)</span>
    104. 

  104.         <span class="k">return</span> <span class="n">new_url</span>            <span class="c1"># return modified URL</span>
    105. 

  105.     <span class="k">return</span> <span class="kc">True</span>                   <span class="c1"># leave URL in field unchanged</span>
    106. 

  106. </pre></div>
    107. 

  107. </div>
    108. 

  108. <p>is applied to all URL fields in the <a class="reference internal" href="#searx.plugins.Plugin.on_result" title="searx.plugins.Plugin.on_result"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Plugin.on_result</span></code></a> hook:</p>
    109. 

  109. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">class</span><span class="w"> </span><span class="nc">MyUrlFilter</span><span class="p">(</span><span class="n">Plugin</span><span class="p">):</span>
    110. 

  110.     <span class="o">...</span>
    111. 

  111.     <span class="k">def</span><span class="w"> </span><span class="nf">on_result</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">request</span><span class="p">,</span> <span class="n">search</span><span class="p">,</span> <span class="n">result</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
    112. 

  112.         <span class="n">result</span><span class="o">.</span><span class="n">filter_urls</span><span class="p">(</span><span class="n">my_url_filter</span><span class="p">)</span>
    113. 

  113.         <span class="k">return</span> <span class="kc">True</span>
    114. 

  114. </pre></div>
    115. 

  115. </div>
    116. 

  116. </section>
    117. 

  117. <section id="implementation">
    118. 

  118. <h2>Implementation<a class="headerlink" href="#implementation" title="Link to this heading">¶</a></h2>
    119. 

  119. <dl class="py class">
    120. 

  120. <dt class="sig sig-object py" id="searx.plugins.Plugin">
    121. 

  121. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">searx.plugins.</span></span><span class="sig-name descname"><span class="pre">Plugin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plg_cfg</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#searx.plugins.PluginCfg" title="searx.plugins._core.PluginCfg"><span class="pre">PluginCfg</span></a></span></em><span class="sig-paren">)</span><a class="reference internal" href="../../_modules/searx/plugins/_core.html#Plugin"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#searx.plugins.Plugin" title="Link to this definition">¶</a></dt>
    122. 

  122. <dd><p>Abstract base class of all Plugins.</p>
    123. 

  123. <dl class="py attribute">
    124. 

  124. <dt class="sig sig-object py" id="searx.plugins.Plugin.id">
    125. 

  125. <span class="sig-name descname"><span class="pre">id</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><span class="pre">str</span></a></em><em class="property"><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="pre">''</span></em><a class="headerlink" href="#searx.plugins.Plugin.id" title="Link to this definition">¶</a></dt>
    126. 

  126. <dd><p>The ID (suffix) in the HTML form.</p>
    127. 

  127. </dd></dl>
    128. 

  128. 

  129. <dl class="py attribute">
    130. 

  130. <dt class="sig sig-object py" id="searx.plugins.Plugin.active">
    131. 

  131. <span class="sig-name descname"><span class="pre">active</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.ClassVar" title="(in Python v3.13)"><span class="pre">ClassVar</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.13)"><span class="pre">bool</span></a><span class="p"><span class="pre">]</span></span></em><a class="headerlink" href="#searx.plugins.Plugin.active" title="Link to this definition">¶</a></dt>
    132. 

  132. <dd><p>Plugin is enabled/disabled by default (<a class="reference internal" href="#searx.plugins.PluginCfg.active" title="searx.plugins.PluginCfg.active"><code class="xref py py-obj docutils literal notranslate"><span class="pre">PluginCfg.active</span></code></a>).</p>
    133. 

  133. </dd></dl>
    134. 

  134. 

  135. <dl class="py attribute">
    136. 

  136. <dt class="sig sig-object py" id="searx.plugins.Plugin.keywords">
    137. 

  137. <span class="sig-name descname"><span class="pre">keywords</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.13)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></em><em class="property"><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="pre">[]</span></em><a class="headerlink" href="#searx.plugins.Plugin.keywords" title="Link to this definition">¶</a></dt>
    138. 

  138. <dd><p>Keywords in the search query that activate the plugin.  The <em>keyword</em> is
    139. 

  139. the first word in a search query.  If a plugin should be executed regardless
    140. 

  140. of the search query, the list of keywords should be empty (which is also the
    141. 

  141. default in the base class for Plugins).</p>
    142. 

  142. </dd></dl>
    143. 

  143. 

  144. <dl class="py attribute">
    145. 

  145. <dt class="sig sig-object py" id="searx.plugins.Plugin.info">
    146. 

  146. <span class="sig-name descname"><span class="pre">info</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference internal" href="#searx.plugins.PluginInfo" title="searx.plugins._core.PluginInfo"><span class="pre">PluginInfo</span></a></em><a class="headerlink" href="#searx.plugins.Plugin.info" title="Link to this definition">¶</a></dt>
    147. 

  147. <dd><p>Information about the <em>plugin</em>, see <a class="reference internal" href="#searx.plugins.PluginInfo" title="searx.plugins.PluginInfo"><code class="xref py py-obj docutils literal notranslate"><span class="pre">PluginInfo</span></code></a>.</p>
    148. 

  148. </dd></dl>
    149. 

  149. 

  150. <dl class="py attribute">
    151. 

  151. <dt class="sig sig-object py" id="searx.plugins.Plugin.log">
    152. 

  152. <span class="sig-name descname"><span class="pre">log</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/logging.html#logging.Logger" title="(in Python v3.13)"><span class="pre">Logger</span></a></em><a class="headerlink" href="#searx.plugins.Plugin.log" title="Link to this definition">¶</a></dt>
    153. 

  153. <dd><p>A logger object, is automatically initialized when calling the
    154. 

  154. constructor (if not already set in the subclass).</p>
    155. 

  155. </dd></dl>
    156. 

  156. 

  157. <dl class="py method">
    158. 

  158. <dt class="sig sig-object py" id="searx.plugins.Plugin.init">
    159. 

  159. <span class="sig-name descname"><span class="pre">init</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://flask.palletsprojects.com/en/stable/api/#flask.Flask" title="(in Flask v3.1.x)"><span class="pre">flask.Flask</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.13)"><span class="pre">bool</span></a></span></span><a class="reference internal" href="../../_modules/searx/plugins/_core.html#Plugin.init"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#searx.plugins.Plugin.init" title="Link to this definition">¶</a></dt>
    160. 

  160. <dd><p>Initialization of the plugin, the return value decides whether this
    161. 

  161. plugin is active or not.  Initialization only takes place once, at the
    162. 

  162. time the WEB application is set up.  The base method always returns
    163. 

  163. <code class="docutils literal notranslate"><span class="pre">True</span></code>, the method can be overwritten in the inheritances,</p>
    164. 

  164. <ul class="simple">
    165. 

  165. <li><p><code class="docutils literal notranslate"><span class="pre">True</span></code> plugin is active</p></li>
    166. 

  166. <li><p><code class="docutils literal notranslate"><span class="pre">False</span></code> plugin is inactive</p></li>
    167. 

  167. </ul>
    168. 

  168. </dd></dl>
    169. 

  169. 

  170. <dl class="py method">
    171. 

  171. <dt class="sig sig-object py" id="searx.plugins.Plugin.pre_search">
    172. 

  172. <span class="sig-name descname"><span class="pre">pre_search</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">request</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="../extended_types.html#searx.extended_types.SXNG_Request" title="searx.extended_types.SXNG_Request"><span class="pre">SXNG_Request</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">search</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="../../src/searx.search.html#searx.search.SearchWithPlugins" title="searx.search.SearchWithPlugins"><span class="pre">SearchWithPlugins</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.13)"><span class="pre">bool</span></a></span></span><a class="reference internal" href="../../_modules/searx/plugins/_core.html#Plugin.pre_search"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#searx.plugins.Plugin.pre_search" title="Link to this definition">¶</a></dt>
    173. 

  173. <dd><p>Runs BEFORE the search request and returns a boolean:</p>
    174. 

  174. <ul class="simple">
    175. 

  175. <li><p><code class="docutils literal notranslate"><span class="pre">True</span></code> to continue the search</p></li>
    176. 

  176. <li><p><code class="docutils literal notranslate"><span class="pre">False</span></code> to stop the search</p></li>
    177. 

  177. </ul>
    178. 

  178. </dd></dl>
    179. 

  179. 

  180. <dl class="py method">
    181. 

  181. <dt class="sig sig-object py" id="searx.plugins.Plugin.on_result">
    182. 

  182. <span class="sig-name descname"><span class="pre">on_result</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">request</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="../extended_types.html#searx.extended_types.SXNG_Request" title="searx.extended_types.SXNG_Request"><span class="pre">SXNG_Request</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">search</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="../../src/searx.search.html#searx.search.SearchWithPlugins" title="searx.search.SearchWithPlugins"><span class="pre">SearchWithPlugins</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">result</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="../result_types/base_result.html#searx.result_types._base.Result" title="searx.result_types._base.Result"><span class="pre">Result</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.13)"><span class="pre">bool</span></a></span></span><a class="reference internal" href="../../_modules/searx/plugins/_core.html#Plugin.on_result"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#searx.plugins.Plugin.on_result" title="Link to this definition">¶</a></dt>
    183. 

  183. <dd><p>Runs for each result of each engine and returns a boolean:</p>
    184. 

  184. <ul class="simple">
    185. 

  185. <li><p><code class="docutils literal notranslate"><span class="pre">True</span></code> to keep the result</p></li>
    186. 

  186. <li><p><code class="docutils literal notranslate"><span class="pre">False</span></code> to remove the result from the result list</p></li>
    187. 

  187. </ul>
    188. 

  188. <p>The <code class="docutils literal notranslate"><span class="pre">result</span></code> can be modified to the needs.</p>
    189. 

  189. <div class="admonition hint">
    190. 

  190. <p class="admonition-title">Hint</p>
    191. 

  191. <p>If <a class="reference internal" href="../result_types/base_result.html#searx.result_types._base.Result.url" title="searx.result_types._base.Result.url"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Result.url</span></code></a> is modified,
    192. 

  192. <a class="reference internal" href="../result_types/base_result.html#searx.result_types._base.Result.parsed_url" title="searx.result_types._base.Result.parsed_url"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Result.parsed_url</span></code></a> must
    193. 

  193. be changed accordingly:</p>
    194. 

  194. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;parsed_url&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">urlparse</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;url&quot;</span><span class="p">])</span>
    195. 

  195. </pre></div>
    196. 

  196. </div>
    197. 

  197. </div>
    198. 

  198. </dd></dl>
    199. 

  199. 

  200. <dl class="py method">
    201. 

  201. <dt class="sig sig-object py" id="searx.plugins.Plugin.post_search">
    202. 

  202. <span class="sig-name descname"><span class="pre">post_search</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">request</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="../extended_types.html#searx.extended_types.SXNG_Request" title="searx.extended_types.SXNG_Request"><span class="pre">SXNG_Request</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">search</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="../../src/searx.search.html#searx.search.SearchWithPlugins" title="searx.search.SearchWithPlugins"><span class="pre">SearchWithPlugins</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.13)"><span class="pre">None</span></a><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Sequence" title="(in Python v3.13)"><span class="pre">Sequence</span></a><span class="p"><span class="pre">[</span></span><a class="reference internal" href="../result_types/base_result.html#searx.result_types._base.Result" title="searx.result_types._base.Result"><span class="pre">Result</span></a><span class="p"><span class="pre">]</span></span></span></span><a class="reference internal" href="../../_modules/searx/plugins/_core.html#Plugin.post_search"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#searx.plugins.Plugin.post_search" title="Link to this definition">¶</a></dt>
    203. 

  203. <dd><p>Runs AFTER the search request.  Can return a list of
    204. 

  204. <a class="reference internal" href="../result_types/base_result.html#searx.result_types._base.Result" title="searx.result_types._base.Result"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Result</span></code></a> objects to be added to the
    205. 

  205. final result list.</p>
    206. 

  206. </dd></dl>
    207. 

  207. 

  208. </dd></dl>
    209. 

  209. 

  210. <dl class="py class">
    211. 

  211. <dt class="sig sig-object py" id="searx.plugins.PluginInfo">
    212. 

  212. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">searx.plugins.</span></span><span class="sig-name descname"><span class="pre">PluginInfo</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">id:</span> <span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">name:</span> <span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">description:</span> <span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">preference_section:</span> <span class="pre">~typing.Literal['general'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">'ui'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">'privacy'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">'query']</span> <span class="pre">|</span> <span class="pre">None</span> <span class="pre">=</span> <span class="pre">'general'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">examples:</span> <span class="pre">list[str]</span> <span class="pre">=</span> <span class="pre">&lt;factory&gt;</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">keywords:</span> <span class="pre">list[str]</span> <span class="pre">=</span> <span class="pre">&lt;factory&gt;</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../../_modules/searx/plugins/_core.html#PluginInfo"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#searx.plugins.PluginInfo" title="Link to this definition">¶</a></dt>
    213. 

  213. <dd><p>Object that holds information about a <em>plugin</em>, these infos are shown to
    214. 

  214. the user in the Preferences menu.</p>
    215. 

  215. <p>To be able to translate the information into other languages, the text must
    216. 

  216. be written in English and translated with <a class="reference external" href="https://python-babel.github.io/flask-babel/index.html#flask_babel.gettext" title="(in Flask-Babel)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">flask_babel.gettext</span></code></a>.</p>
    217. 

  217. <dl class="py attribute">
    218. 

  218. <dt class="sig sig-object py" id="searx.plugins.PluginInfo.id">
    219. 

  219. <span class="sig-name descname"><span class="pre">id</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><span class="pre">str</span></a></em><a class="headerlink" href="#searx.plugins.PluginInfo.id" title="Link to this definition">¶</a></dt>
    220. 

  220. <dd><p>The ID-selector in HTML/CSS <cite>#&lt;id&gt;</cite>.</p>
    221. 

  221. </dd></dl>
    222. 

  222. 

  223. <dl class="py attribute">
    224. 

  224. <dt class="sig sig-object py" id="searx.plugins.PluginInfo.name">
    225. 

  225. <span class="sig-name descname"><span class="pre">name</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><span class="pre">str</span></a></em><a class="headerlink" href="#searx.plugins.PluginInfo.name" title="Link to this definition">¶</a></dt>
    226. 

  226. <dd><p>Name of the <em>plugin</em>.</p>
    227. 

  227. </dd></dl>
    228. 

  228. 

  229. <dl class="py attribute">
    230. 

  230. <dt class="sig sig-object py" id="searx.plugins.PluginInfo.description">
    231. 

  231. <span class="sig-name descname"><span class="pre">description</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><span class="pre">str</span></a></em><a class="headerlink" href="#searx.plugins.PluginInfo.description" title="Link to this definition">¶</a></dt>
    232. 

  232. <dd><p>Short description of the <em>answerer</em>.</p>
    233. 

  233. </dd></dl>
    234. 

  234. 

  235. <dl class="py attribute">
    236. 

  236. <dt class="sig sig-object py" id="searx.plugins.PluginInfo.preference_section">
    237. 

  237. <span class="sig-name descname"><span class="pre">preference_section</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Literal" title="(in Python v3.13)"><span class="pre">Literal</span></a><span class="p"><span class="pre">[</span></span><span class="s"><span class="pre">'general'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'ui'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'privacy'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'query'</span></span><span class="p"><span class="pre">]</span></span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.13)"><span class="pre">None</span></a></em><em class="property"><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="pre">'general'</span></em><a class="headerlink" href="#searx.plugins.PluginInfo.preference_section" title="Link to this definition">¶</a></dt>
    238. 

  238. <dd><p>Section (tab/group) in the preferences where this plugin is shown to the
    239. 

  239. user.</p>
    240. 

  240. <p>The value <code class="docutils literal notranslate"><span class="pre">query</span></code> is reserved for plugins that are activated via a
    241. 

  241. <em>keyword</em> as part of a search query, see:</p>
    242. 

  242. <ul class="simple">
    243. 

  243. <li><p><a class="reference internal" href="#searx.plugins.PluginInfo.examples" title="searx.plugins.PluginInfo.examples"><code class="xref py py-obj docutils literal notranslate"><span class="pre">PluginInfo.examples</span></code></a></p></li>
    244. 

  244. <li><p><a class="reference internal" href="#searx.plugins.Plugin.keywords" title="searx.plugins.Plugin.keywords"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Plugin.keywords</span></code></a></p></li>
    245. 

  245. </ul>
    246. 

  246. <p>Those plugins are shown in the preferences in tab <em>Special Queries</em>.</p>
    247. 

  247. </dd></dl>
    248. 

  248. 

  249. <dl class="py attribute">
    250. 

  250. <dt class="sig sig-object py" id="searx.plugins.PluginInfo.examples">
    251. 

  251. <span class="sig-name descname"><span class="pre">examples</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.13)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></em><a class="headerlink" href="#searx.plugins.PluginInfo.examples" title="Link to this definition">¶</a></dt>
    252. 

  252. <dd><p>List of short examples of the usage / of query terms.</p>
    253. 

  253. </dd></dl>
    254. 

  254. 

  255. <dl class="py attribute">
    256. 

  256. <dt class="sig sig-object py" id="searx.plugins.PluginInfo.keywords">
    257. 

  257. <span class="sig-name descname"><span class="pre">keywords</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.13)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></em><a class="headerlink" href="#searx.plugins.PluginInfo.keywords" title="Link to this definition">¶</a></dt>
    258. 

  258. <dd><p>See <a class="reference internal" href="#searx.plugins.Plugin.keywords" title="searx.plugins.Plugin.keywords"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Plugin.keywords</span></code></a></p>
    259. 

  259. </dd></dl>
    260. 

  260. 

  261. </dd></dl>
    262. 

  262. 

  263. <dl class="py class">
    264. 

  264. <dt class="sig sig-object py" id="searx.plugins.PluginStorage">
    265. 

  265. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">searx.plugins.</span></span><span class="sig-name descname"><span class="pre">PluginStorage</span></span><a class="reference internal" href="../../_modules/searx/plugins/_core.html#PluginStorage"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#searx.plugins.PluginStorage" title="Link to this definition">¶</a></dt>
    266. 

  266. <dd><p>A storage for managing the <em>plugins</em> of SearXNG.</p>
    267. 

  267. <dl class="py attribute">
    268. 

  268. <dt class="sig sig-object py" id="searx.plugins.PluginStorage.plugin_list">
    269. 

  269. <span class="sig-name descname"><span class="pre">plugin_list</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#set" title="(in Python v3.13)"><span class="pre">set</span></a><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#searx.plugins.Plugin" title="searx.plugins._core.Plugin"><span class="pre">Plugin</span></a><span class="p"><span class="pre">]</span></span></em><a class="headerlink" href="#searx.plugins.PluginStorage.plugin_list" title="Link to this definition">¶</a></dt>
    270. 

  270. <dd><p>The list of <code class="xref py py-obj docutils literal notranslate"><span class="pre">Plugins</span></code> in this storage.</p>
    271. 

  271. </dd></dl>
    272. 

  272. 

  273. <dl class="py method">
    274. 

  274. <dt class="sig sig-object py" id="searx.plugins.PluginStorage.load_settings">
    275. 

  275. <span class="sig-name descname"><span class="pre">load_settings</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">cfg</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#dict" title="(in Python v3.13)"><span class="pre">dict</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#dict" title="(in Python v3.13)"><span class="pre">dict</span></a><span class="p"><span class="pre">]</span></span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../../_modules/searx/plugins/_core.html#PluginStorage.load_settings"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#searx.plugins.PluginStorage.load_settings" title="Link to this definition">¶</a></dt>
    276. 

  276. <dd><p>Load plugins configured in SearXNG’s settings <a class="reference internal" href="../../admin/settings/settings_plugins.html#settings-plugins"><span class="std std-ref">plugins:</span></a>.</p>
    277. 

  277. </dd></dl>
    278. 

  278. 

  279. <dl class="py method">
    280. 

  280. <dt class="sig sig-object py" id="searx.plugins.PluginStorage.register">
    281. 

  281. <span class="sig-name descname"><span class="pre">register</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#searx.plugins.Plugin" title="searx.plugins._core.Plugin"><span class="pre">Plugin</span></a></span></em><span class="sig-paren">)</span><a class="reference internal" href="../../_modules/searx/plugins/_core.html#PluginStorage.register"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#searx.plugins.PluginStorage.register" title="Link to this definition">¶</a></dt>
    282. 

  282. <dd><p>Register a <a class="reference internal" href="#searx.plugins.Plugin" title="searx.plugins.Plugin"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Plugin</span></code></a>.  In case of name collision (if two
    283. 

  283. plugins have same ID) a <a class="reference external" href="https://docs.python.org/3/library/exceptions.html#KeyError" title="(in Python v3.13)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">KeyError</span></code></a> exception is raised.</p>
    284. 

  284. </dd></dl>
    285. 

  285. 

  286. <dl class="py method">
    287. 

  287. <dt class="sig sig-object py" id="searx.plugins.PluginStorage.init">
    288. 

  288. <span class="sig-name descname"><span class="pre">init</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://flask.palletsprojects.com/en/stable/api/#flask.Flask" title="(in Flask v3.1.x)"><span class="pre">flask.Flask</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.13)"><span class="pre">None</span></a></span></span><a class="reference internal" href="../../_modules/searx/plugins/_core.html#PluginStorage.init"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#searx.plugins.PluginStorage.init" title="Link to this definition">¶</a></dt>
    289. 

  289. <dd><p>Calls the method <a class="reference internal" href="#searx.plugins.Plugin.init" title="searx.plugins.Plugin.init"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Plugin.init</span></code></a> of each plugin in this
    290. 

  290. storage.  Depending on its return value, the plugin is removed from
    291. 

  291. <em>this</em> storage or not.</p>
    292. 

  292. </dd></dl>
    293. 

  293. 

  294. <dl class="py method">
    295. 

  295. <dt class="sig sig-object py" id="searx.plugins.PluginStorage.post_search">
    296. 

  296. <span class="sig-name descname"><span class="pre">post_search</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">request</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="../extended_types.html#searx.extended_types.SXNG_Request" title="searx.extended_types.SXNG_Request"><span class="pre">SXNG_Request</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">search</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="../../src/searx.search.html#searx.search.SearchWithPlugins" title="searx.search.SearchWithPlugins"><span class="pre">SearchWithPlugins</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.13)"><span class="pre">None</span></a></span></span><a class="reference internal" href="../../_modules/searx/plugins/_core.html#PluginStorage.post_search"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#searx.plugins.PluginStorage.post_search" title="Link to this definition">¶</a></dt>
    297. 

  297. <dd><p>Extend <code class="xref py py-obj docutils literal notranslate"><span class="pre">search.result_container</span>
    298. 

  298. <span class="pre">&lt;searx.results.ResultContainer</span></code>&gt; with result items from plugins listed
    299. 

  299. in <code class="xref py py-obj docutils literal notranslate"><span class="pre">search.user_plugins</span></code>.</p>
    300. 

  300. </dd></dl>
    301. 

  301. 

  302. </dd></dl>
    303. 

  303. 

  304. <dl class="py class">
    305. 

  305. <dt class="sig sig-object py" id="searx.plugins.PluginCfg">
    306. 

  306. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">searx.plugins.</span></span><span class="sig-name descname"><span class="pre">PluginCfg</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">active</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.13)"><span class="pre">bool</span></a></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../../_modules/searx/plugins/_core.html#PluginCfg"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#searx.plugins.PluginCfg" title="Link to this definition">¶</a></dt>
    307. 

  307. <dd><p>Settings of a plugin.</p>
    308. 

  308. <div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">mypackage.mymodule.MyPlugin</span><span class="p">:</span>
    309. 

  309. <span class="w">  </span><span class="nt">active</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
    310. 

  310. </pre></div>
    311. 

  311. </div>
    312. 

  312. <dl class="py attribute">
    313. 

  313. <dt class="sig sig-object py" id="searx.plugins.PluginCfg.active">
    314. 

  314. <span class="sig-name descname"><span class="pre">active</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.13)"><span class="pre">bool</span></a></em><em class="property"><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="pre">False</span></em><a class="headerlink" href="#searx.plugins.PluginCfg.active" title="Link to this definition">¶</a></dt>
    315. 

  315. <dd><p>Plugin is active by default and the user can <em>opt-out</em> in the preferences.</p>
    316. 

  316. </dd></dl>
    317. 

  317. 

  318. </dd></dl>
    319. 

  319. 

  320. </section>
    321. 

  321. </section>
    322. 

  322. 

  323. 

  324.             <div class="clearer"></div>
    325. 

  325.           </div>
    326. 

  326.         </div>
    327. 

  327.       </div>
    328. 

  328.   <span id="sidebar-top"></span>
    329. 

  329.       <div class="sphinxsidebar" role="navigation" aria-label="Main">
    330. 

  330.         <div class="sphinxsidebarwrapper">
    331. 

  331.   
    332. 

  332.     
    333. 

  333.             <p class="logo"><a href="../../index.html">
    334. 

  334.               <img class="logo" src="../../_static/searxng-wordmark.svg" alt="Logo of SearXNG"/>
    335. 

  335.             </a></p>
    336. 

  336.   
    337. 

  337. 

  338. <h3><a href="../../index.html">Table of Contents</a></h3>
    339. 

  339. <ul class="current">
    340. 

  340. <li class="toctree-l1"><a class="reference internal" href="../../user/index.html">User information</a></li>
    341. 

  341. <li class="toctree-l1"><a class="reference internal" href="../../own-instance.html">Why use a private instance?</a></li>
    342. 

  342. <li class="toctree-l1"><a class="reference internal" href="../../admin/index.html">Administrator documentation</a></li>
    343. 

  343. <li class="toctree-l1 current"><a class="reference internal" href="../index.html">Developer documentation</a><ul class="current">
    344. 

  344. <li class="toctree-l2"><a class="reference internal" href="../quickstart.html">Development Quickstart</a></li>
    345. 

  345. <li class="toctree-l2"><a class="reference internal" href="../commits.html">Git Commits &amp; Change Management</a></li>
    346. 

  346. <li class="toctree-l2"><a class="reference internal" href="../rtm_asdf.html">Runtime Management</a></li>
    347. 

  347. <li class="toctree-l2"><a class="reference internal" href="../contribution_guide.html">How to contribute</a></li>
    348. 

  348. <li class="toctree-l2"><a class="reference internal" href="../extended_types.html">Extended Types</a></li>
    349. 

  349. <li class="toctree-l2"><a class="reference internal" href="../engines/index.html">Engine Implementations</a></li>
    350. 

  350. <li class="toctree-l2"><a class="reference internal" href="../result_types/index.html">Result Types</a></li>
    351. 

  351. <li class="toctree-l2"><a class="reference internal" href="../templates.html">Simple Theme Templates</a></li>
    352. 

  352. <li class="toctree-l2"><a class="reference internal" href="../search_api.html">Search API</a></li>
    353. 

  353. <li class="toctree-l2 current"><a class="reference internal" href="index.html">Plugins</a><ul class="current">
    354. 

  354. <li class="toctree-l3 current"><a class="current reference internal" href="#">Plugin Development</a><ul>
    355. 

  355. <li class="toctree-l4"><a class="reference internal" href="#add-answer-example">Add Answer example</a></li>
    356. 

  356. <li class="toctree-l4"><a class="reference internal" href="#filter-urls-example">Filter URLs example</a></li>
    357. 

  357. <li class="toctree-l4"><a class="reference internal" href="#implementation">Implementation</a><ul>
    358. 

  358. <li class="toctree-l5"><a class="reference internal" href="#searx.plugins.Plugin"><code class="docutils literal notranslate"><span class="pre">Plugin</span></code></a></li>
    359. 

  359. <li class="toctree-l5"><a class="reference internal" href="#searx.plugins.PluginInfo"><code class="docutils literal notranslate"><span class="pre">PluginInfo</span></code></a></li>
    360. 

  360. <li class="toctree-l5"><a class="reference internal" href="#searx.plugins.PluginStorage"><code class="docutils literal notranslate"><span class="pre">PluginStorage</span></code></a></li>
    361. 

  361. <li class="toctree-l5"><a class="reference internal" href="#searx.plugins.PluginCfg"><code class="docutils literal notranslate"><span class="pre">PluginCfg</span></code></a></li>
    362. 

  362. </ul>
    363. 

  363. </li>
    364. 

  364. </ul>
    365. 

  365. </li>
    366. 

  366. <li class="toctree-l3"><a class="reference internal" href="builtins.html">Built-in Plugins</a></li>
    367. 

  367. </ul>
    368. 

  368. </li>
    369. 

  369. <li class="toctree-l2"><a class="reference internal" href="../answerers/index.html">Answerers</a></li>
    370. 

  370. <li class="toctree-l2"><a class="reference internal" href="../translation.html">Translation</a></li>
    371. 

  371. <li class="toctree-l2"><a class="reference internal" href="../makefile.html">Makefile &amp; <code class="docutils literal notranslate"><span class="pre">./manage</span></code></a></li>
    372. 

  372. <li class="toctree-l2"><a class="reference internal" href="../reST.html">reST primer</a></li>
    373. 

  373. <li class="toctree-l2"><a class="reference internal" href="../searxng_extra/index.html">Tooling box <code class="docutils literal notranslate"><span class="pre">searxng_extra</span></code></a></li>
    374. 

  374. </ul>
    375. 

  375. </li>
    376. 

  376. <li class="toctree-l1"><a class="reference internal" href="../../utils/index.html">DevOps tooling box</a></li>
    377. 

  377. <li class="toctree-l1"><a class="reference internal" href="../../src/index.html">Source-Code</a></li>
    378. 

  378. </ul>
    379. 

  379. 

  380.   <h3>Project Links</h3>
    381. 

  381.   <ul>
    382. 

  382.     <li><a href="https://github.com/searxng/searxng/tree/master">Source</a>
    383. 

  383.   
    384. 

  384.     <li><a href="https://github.com/searxng/searxng/wiki">Wiki</a>
    385. 

  385.   
    386. 

  386.     <li><a href="https://searx.space">Public instances</a>
    387. 

  387.   
    388. 

  388.     <li><a href="https://github.com/searxng/searxng/issues">Issue Tracker</a>
    389. 

  389.   </ul><h3>Navigation</h3>
    390. 

  390. <ul>
    391. 

  391.   <li><a href="../../index.html">Overview</a>
    392. 

  392.     <ul>
    393. 

  393.       <li><a href="../index.html">Developer documentation</a>
    394. 

  394.         <ul>
    395. 

  395.       <li><a href="index.html">Plugins</a>
    396. 

  396.         <ul>
    397. 

  397.           <li>Previous: <a href="index.html" title="previous chapter">Plugins</a>
    398. 

  398.           <li>Next: <a href="builtins.html" title="next chapter">Built-in Plugins</a></ul>
    399. 

  399.       </li></ul>
    400. 

  400.       </li>
    401. 

  401.     </ul>
    402. 

  402.   </li>
    403. 

  403. </ul>
    404. 

  404. <search id="searchbox" style="display: none" role="search">
    405. 

  405.   <h3 id="searchlabel">Quick search</h3>
    406. 

  406.     <div class="searchformwrapper">
    407. 

  407.     <form class="search" action="../../search.html" method="get">
    408. 

  408.       <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
    409. 

  409.       <input type="submit" value="Go" />
    410. 

  410.     </form>
    411. 

  411.     </div>
    412. 

  412. </search>
    413. 

  413. <script>document.getElementById('searchbox').style.display = "block"</script>
    414. 

  414.   <div role="note" aria-label="source link">
    415. 

  415.     <h3>This Page</h3>
    416. 

  416.     <ul class="this-page-menu">
    417. 

  417.       <li><a href="../../_sources/dev/plugins/development.rst.txt"
    418. 

  418.             rel="nofollow">Show Source</a></li>
    419. 

  419.     </ul>
    420. 

  420.    </div>
    421. 

  421.         </div>
    422. 

  422.       </div>
    423. 

  423.       <div class="clearer"></div>
    424. 

  424.     </div>
    425. 

  425.     <div class="footer" role="contentinfo">
    426. 

  426.     &#169; Copyright SearXNG team.
    427. 

  427.     </div>
    428. 

  428.   </body>
    429. 

  429. </html>
    430.
© 2025 NTab仓库
Page: 363ms Template: 1ms 微信 微信二维码 哔哩哔哩 Sina Weibo Javascript Licenses Website