SearXNG服务：强大灵活的搜索工具 | SearXNG使用指南

在信息爆炸的时代，拥有一个强大又灵活的搜索工具就像拥有了探索网络世界的魔法钥匙。今天，我们为大家带来了这样一把魔法钥匙——SearXNG服务。这款基于TypeScript的服务能够与SearXNG搜索引擎API无缝对接，让您轻松执行搜索并获取各种格式的结果。无论是开发炫酷的Web应用，还是需要强劲的后端搜索支持，SearXNG服务都能轻松胜任。

为什么选择SearXNG服务？

SearXNG服务不仅仅是一款工具，它更像是您的搜索小伙伴，让您的开发工作事半功倍。

1. 无限定制：可以根据您的需求随心所欲地调整搜索参数，选择不同的类别、引擎和语言，让搜索结果更精准。
2. 简易操作：从安装到使用，整个过程简单明了，无需繁琐的配置，瞬间上手。
3. 多功能支持：支持JSON、CSV和RSS等多种格式的搜索结果，让您的应用适应更多场景。

安装与配置

一键安装

只需一条命令，就能让SearXNG服务快速加入您的开发队伍：

npm install searxng

配置设置

导入并配置SearXNG服务，让它为您效劳：

import { SearxngService, type SearxngServiceConfig } from 'searxng';

const config: SearxngServiceConfig = {
  baseURL: 'https://your-searxng-instance.com',
  defaultSearchParams: {
    format: 'json',
    lang: 'auto',
  },
  defaultRequestHeaders: {
    'Content-Type': 'application/json',
  },
};

const searxngService = new SearxngService(config);

类型和参数

类别

想要搜索什么内容？选择范围广泛的类别，让结果更符合您的需求：

export type SearxngCategory =
  | 'general'
  | 'web'
  | 'images'
  | 'videos'
  | 'news'
  | 'music'
  // 根据需要添加更多类别
  ;

引擎和语言

选择您喜爱的搜索引擎和语言，定制专属您的搜索体验：

export type SearxngEngine =
  | 'google'
  | 'bing'
  | 'duckduckgo'
  // 添加更多引擎
  ;

export type SearxngLocale =
  | 'en'
  | 'es'
  | 'fr'
  // 添加更多语言
  ;

方法

使用 search 方法，开始您的探索之旅：

async search(
  input: string,
  params?: Partial<SearxngSearchParameters>,
): Promise<SearxngSearchResults>

示例：基本搜索

执行一次简单搜索，看看魔法钥匙的威力：

async function performSearch() {
  try {
    const results = await searxngService.search('示例查询');
    console.log(results);
  } catch (error) {
    console.error('搜索失败:', error);
  }
}

performSearch();

示例：带参数的搜索

用更多参数进行搜索，探索更多可能：

async function performSearchWithParams() {
  const searchParams = {
    categories: ['general', 'web'],
    engines: ['google', 'bing'],
    lang: 'en',
    pageno: 2,
    time_range: 'month',
    format: 'json',
  };

  try {
    const results = await searxngService.search('示例查询', searchParams);
    console.log(results);
  } catch (error) {
    console.error('搜索失败:', error);
  }
}

performSearchWithParams();

结语

SearXNG服务不仅仅是一个工具，它更像是您的搜索魔法棒，让复杂的搜索变得简单有趣。无论您是开发者还是技术爱好者，SearXNG服务都能帮助您实现更强大的搜索功能。立即安装SearXNG服务，开启您的魔法搜索之旅吧！