@endday/search-mcp 1.0.0 → 1.0.1

package/src/search/engines/baidu.impl.js

@@ -1,145 +0,0 @@
-import { ApiError } from "../../core/errors.js";
-import { fetchSearchText } from "../engineRequest.js";
-import { ensureAbsoluteUrl, mapTimeRange, resolvePageNumber } from "../engineUtils.js";
-import { cleanText, parseHtml } from "../../core/html.js";
-import { normalizeResults } from "../ranking.js";
-
-const BAIDU_TIME_RANGE = {
-  day: "1",
-  week: "2",
-  month: "3",
-  year: "4",
-};
-
-function extractBaiduResultUrl(node, linkNode) {
-  const mu = node.getAttribute("mu");
-  if (mu) {
-    return ensureAbsoluteUrl(mu, "https://www.baidu.com");
-  }
-
-  return ensureAbsoluteUrl(
-    linkNode?.getAttribute("href"),
-    "https://www.baidu.com"
-  );
-}
-
-function extractBaiduTitle(node, linkNode) {
-  const titleNode =
-    node.querySelector("h3 a") ||
-    node.querySelector("h3") ||
-    linkNode;
-
-  return cleanText(titleNode?.innerHTML || titleNode?.text || "");
-}
-
-export function parseBaiduResults(html) {
-  const root = parseHtml(html);
-  const resultNodes = root.querySelectorAll(
-    "#content_left .result, #content_left .result-op"
-  );
-  const results = [];
-
-  for (const node of resultNodes) {
-    const linkNode = node.querySelector("h3 a[href]");
-    if (!linkNode) {
-      continue;
-    }
-
-    const url = extractBaiduResultUrl(node, linkNode);
-    if (!url || /^https?:\/\/(?:www\.)?baidu\.com\//i.test(url)) {
-      continue;
-    }
-
-    const descriptionNode =
-      node.querySelector('[data-sanssr-cmpt="card/www-summary"]') ||
-      node.querySelector(".c-span-last p") ||
-      node.querySelector(".content-right_8Zs40") ||
-      node.querySelector(".c-color-text") ||
-      node.querySelector(".c-line-clamp3") ||
-      node.querySelector("p");
-
-    results.push({
-      title: extractBaiduTitle(node, linkNode),
-      url,
-      description: cleanText(
-        descriptionNode?.innerHTML || descriptionNode?.text || ""
-      ),
-    });
-  }
-
-  const normalized = normalizeResults(results);
-  if (normalized.length === 0) {
-    throw new ApiError({
-      status: 502,
-      code: "UPSTREAM_PARSE_ERROR",
-      category: "upstream",
-      message: "Baidu parser could not find organic results",
-    });
-  }
-
-  return normalized;
-}
-
-function buildBaiduSearchUrl({ query, time_range, pageno }) {
-  const page = resolvePageNumber(pageno);
-  const searchUrl = new URL("https://www.baidu.com/s");
-  searchUrl.searchParams.set("wd", query);
-  searchUrl.searchParams.set("ie", "utf-8");
-  searchUrl.searchParams.set("rn", "10");
-
-  if (page > 0) {
-    searchUrl.searchParams.set("pn", String(page * 10));
-  }
-
-  const timeFilter = mapTimeRange(time_range, BAIDU_TIME_RANGE);
-  if (timeFilter) {
-    searchUrl.searchParams.set("gpc", `stf=${timeFilter}`);
-  }
-
-  return searchUrl;
-}
-
-async function searchBaidu(params) {
-  const { query, language, time_range, pageno, signal, runtimeContext } = params;
-  const searchUrl = buildBaiduSearchUrl({
-    query,
-    time_range,
-    pageno,
-  });
-
-  const html = await fetchSearchText(searchUrl.toString(), {
-    engine: "baidu",
-    engineLabel: "Baidu",
-    signal,
-    language,
-    cookies: {
-      BAIDUID_BFESS: "search-mcp",
-      PSTM: "0",
-    },
-    referrer: "https://www.baidu.com/",
-    runtimeContext,
-    blockedStatuses: [403, 429],
-  });
-
-  return parseBaiduResults(html);
-}
-
-export const baiduAdapter = {
-  name: "baidu",
-  label: "Baidu",
-  priority: 60,
-  tier: "primary",
-  requestPolicy: {
-    retryAttempts: 1,
-    minRequestIntervalMs: 150,
-  },
-  supports: {
-    language: false,
-    time_range: true,
-    pageno: true,
-  },
-  isAvailable: () => true,
-  search: searchBaidu,
-};
-
-export default searchBaidu;

package/src/search/engines/baidu.js

@@ -1,2 +0,0 @@
-export * from "./baidu.impl.js";
-export { default } from "./baidu.impl.js";

package/src/search/engines/bing.impl.js

@@ -1,509 +0,0 @@
-import { ApiError } from "../../core/errors.js";
-import {
-  fetchSearchText,
-  isChallengeResponse,
-  throwBlockedUpstreamError,
-} from "../engineRequest.js";
-import {
-  ensureAbsoluteUrl,
-  getAcceptLanguageHeader,
-  mapLanguage,
-  mapTimeRange,
-  resolvePageNumber,
-} from "../engineUtils.js";
-import { cleanText, parseHtml } from "../../core/html.js";
-import { normalizeResults } from "../ranking.js";
-
-const BING_TIME_RANGE = {
-  day: '+filterui:age-lt1440',
-  week: '+filterui:age-lt10080',
-  month: '+filterui:age-lt43200',
-  year: '+filterui:age-lt525600',
-};
-
-const BING_LANGUAGE = {
-  en: { setlang: "en-US", cc: "us", mkt: "en-US" },
-  "en-us": { setlang: "en-US", cc: "us", mkt: "en-US" },
-  "en-gb": { setlang: "en-GB", cc: "gb", mkt: "en-GB" },
-  zh: { setlang: "zh-Hans", cc: "cn", mkt: "zh-CN" },
-  "zh-cn": { setlang: "zh-Hans", cc: "cn", mkt: "zh-CN" },
-  "zh-tw": { setlang: "zh-Hant", cc: "tw", mkt: "zh-TW" },
-};
-
-const XML_ENTITIES = {
-  amp: "&",
-  lt: "<",
-  gt: ">",
-  quot: '"',
-  apos: "'",
-};
-
-const BING_CHALLENGE_PATTERNS = [
-  /\bid=["']b_captcha["']\b/i,
-  /\bb_captcha\b/i,
-  /\/turing\//i,
-  /\/challenge\.aspx/i,
-];
-
-function decodeBase64(value) {
-  const normalized = value.replace(/-/g, "+").replace(/_/g, "/");
-  const padding = "=".repeat((4 - (normalized.length % 4)) % 4);
-  const binary = atob(normalized + padding);
-  const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
-  return new TextDecoder().decode(bytes);
-}
-
-function decodeXmlEntities(value) {
-  return String(value || "").replace(
-    /&(#x[0-9a-f]+|#\d+|amp|lt|gt|quot|apos);/gi,
-    (match, entity) => {
-      const normalized = entity.toLowerCase();
-
-      if (normalized.startsWith("#")) {
-        const isHex = normalized[1] === "x";
-        const codePoint = Number.parseInt(
-          normalized.slice(isHex ? 2 : 1),
-          isHex ? 16 : 10
-        );
-
-        if (Number.isNaN(codePoint)) {
-          return match;
-        }
-
-        try {
-          return String.fromCodePoint(codePoint);
-        } catch (_) {
-          return match;
-        }
-      }
-
-      return XML_ENTITIES[normalized] || match;
-    }
-  );
-}
-
-function isBingChallengeResponse(source) {
-  const text = String(source || "");
-  const hasChallengeMessage =
-    /\bverify\s+you\s+are\s+(?:a\s+)?human\b/i.test(text) ||
-    /\bunusual\s+traffic\b/i.test(text);
-  const hasOrganicMarkers =
-    /\bid=["']b_results["']/i.test(text) ||
-    /\bb_algo\b/i.test(text) ||
-    /<main\b/i.test(text);
-
-  return (
-    isChallengeResponse(text, BING_CHALLENGE_PATTERNS) ||
-    (hasChallengeMessage && !hasOrganicMarkers)
-  );
-}
-
-function throwBingChallengeError(surface) {
-  throwBlockedUpstreamError({
-    engine: "Bing",
-    surface,
-  });
-}
-
-export function extractBingRedirectUrl(bingUrl) {
-  if (!bingUrl || !bingUrl.includes("bing.com/ck/a?")) {
-    return bingUrl;
-  }
-
-  try {
-    const decodedUrl = bingUrl.replace(/&amp;/g, "&");
-    const url = new URL(decodedUrl);
-    const uParam = url.searchParams.get("u");
-
-    if (!uParam?.startsWith("a1")) {
-      return bingUrl;
-    }
-
-    return decodeBase64(uParam.slice(2));
-  } catch (_) {
-    return bingUrl;
-  }
-}
-
-export function extractBingNewsRedirectUrl(bingUrl) {
-  if (!bingUrl || !bingUrl.includes("bing.com/news/apiclick.aspx?")) {
-    return extractBingRedirectUrl(bingUrl);
-  }
-
-  try {
-    const decodedUrl = bingUrl.replace(/&amp;/g, "&");
-    const url = new URL(decodedUrl);
-    const target = url.searchParams.get("url");
-    return target ? decodeURIComponent(target) : bingUrl;
-  } catch (_) {
-    return bingUrl;
-  }
-}
-
-export function parseBingResults(html) {
-  if (isBingChallengeResponse(html)) {
-    throwBingChallengeError("html");
-  }
-
-  const root = parseHtml(html);
-  const candidateNodes = collectBingResultNodes(root);
-  const results = [];
-
-  for (const node of candidateNodes) {
-    const linkNode = node.querySelector("h2 a[href]");
-    if (!linkNode) {
-      continue;
-    }
-
-    const title = cleanText(linkNode.innerHTML || linkNode.text);
-    const rawUrl = ensureAbsoluteUrl(
-      linkNode.getAttribute("href"),
-      "https://www.bing.com"
-    );
-    const url = extractBingRedirectUrl(rawUrl);
-    const descriptionNode =
-      node.querySelector(".b_caption p") ||
-      node.querySelector(".b_snippet") ||
-      node.querySelector("p");
-    const description = cleanText(
-      descriptionNode?.innerHTML || descriptionNode?.text || ""
-    );
-
-    results.push({
-      title,
-      url,
-      description,
-    });
-  }
-
-  if (results.length === 0) {
-    const fallbackLinkCount = root.querySelectorAll("main h2 a[href]").length;
-    throw new ApiError({
-      status: 502,
-      code: "UPSTREAM_PARSE_ERROR",
-      category: "upstream",
-      message: `Bing parser could not find organic results (h2_links=${fallbackLinkCount})`,
-    });
-  }
-
-  return normalizeResults(results);
-}
-
-function extractXmlTagContent(source, tagName) {
-  const match = source.match(new RegExp(`<${tagName}[^>]*>([\\s\\S]*?)</${tagName}>`, "i"));
-  if (!match) {
-    return "";
-  }
-
-  return match[1]
-    .replace(/<!\[CDATA\[([\s\S]*?)\]\]>/gi, "$1")
-    .trim();
-}
-
-export function parseBingRssResults(xml) {
-  if (isBingChallengeResponse(xml)) {
-    throwBingChallengeError("rss");
-  }
-
-  const items = [...xml.matchAll(/<item\b[^>]*>([\s\S]*?)<\/item>/gi)];
-  const results = normalizeResults(
-    items.map((item) => {
-      const source = item[1];
-
-      return {
-        title: cleanText(extractXmlTagContent(source, "title")),
-        url: extractBingRedirectUrl(
-          decodeXmlEntities(extractXmlTagContent(source, "link"))
-        ),
-        description: cleanText(extractXmlTagContent(source, "description")),
-      };
-    })
-  );
-
-  if (items.length === 0 || results.length === 0) {
-    throw new ApiError({
-      status: 502,
-      code: "UPSTREAM_PARSE_ERROR",
-      category: "upstream",
-      message: `Bing RSS parser could not find valid results (items=${items.length}, normalized=${results.length})`,
-    });
-  }
-
-  return results;
-}
-
-export function parseBingNewsRssResults(xml) {
-  if (isBingChallengeResponse(xml)) {
-    throwBingChallengeError("rss");
-  }
-
-  const items = [...xml.matchAll(/<item\b[^>]*>([\s\S]*?)<\/item>/gi)];
-  const results = normalizeResults(
-    items.map((item) => {
-      const source = item[1];
-
-      return {
-        title: cleanText(extractXmlTagContent(source, "title")),
-        url: extractBingNewsRedirectUrl(
-          decodeXmlEntities(extractXmlTagContent(source, "link"))
-        ),
-        description: cleanText(extractXmlTagContent(source, "description")),
-        published_text: cleanText(extractXmlTagContent(source, "pubDate")),
-        source_name: cleanText(extractXmlTagContent(source, "News:Source")),
-      };
-    })
-  );
-
-  if (items.length === 0 || results.length === 0) {
-    throw new ApiError({
-      status: 502,
-      code: "UPSTREAM_PARSE_ERROR",
-      category: "upstream",
-      message: `Bing News RSS parser could not find valid results (items=${items.length}, normalized=${results.length})`,
-    });
-  }
-
-  return results;
-}
-
-function isBingNoiseNode(node) {
-  let current = node;
-
-  while (current) {
-    const id = current.getAttribute?.("id") || "";
-    const className = current.getAttribute?.("class") || "";
-    const classList = className.split(/\s+/).filter(Boolean);
-
-    if (
-      id === "b_context" ||
-      id === "b_pole" ||
-      classList.includes("b_pag") ||
-      classList.includes("b_ad")
-    ) {
-      return true;
-    }
-
-    current = current.parentNode;
-  }
-
-  return false;
-}
-
-function findBingResultContainer(node) {
-  let current = node;
-  let nearestContainer = node.parentNode || node;
-
-  while (current) {
-    if (["li", "div", "article", "section"].includes(current.rawTagName)) {
-      nearestContainer = current;
-    }
-
-    const id = current.getAttribute?.("id") || "";
-    if (id === "b_results" || current.rawTagName === "main") {
-      return nearestContainer;
-    }
-
-    current = current.parentNode;
-  }
-
-  return nearestContainer;
-}
-
-function collectBingResultNodes(root) {
-  const selectors = ["li.b_algo", "div.b_algo", "#b_results h2 a[href]", "main h2 a[href]"];
-  const seenNodes = new Set();
-  const resultNodes = [];
-
-  for (const selector of selectors) {
-    for (const node of root.querySelectorAll(selector)) {
-      const linkNode = node.rawTagName === "a" ? node : node.querySelector("h2 a[href]");
-      if (!linkNode || isBingNoiseNode(linkNode)) {
-        continue;
-      }
-
-      const href = ensureAbsoluteUrl(linkNode.getAttribute("href"), "https://www.bing.com");
-      if (!href || href.startsWith("https://www.bing.com/search?")) {
-        continue;
-      }
-
-      const container = node.rawTagName === "a" ? findBingResultContainer(node) : node;
-      if (!container || seenNodes.has(container)) {
-        continue;
-      }
-
-      seenNodes.add(container);
-      resultNodes.push(container);
-    }
-  }
-
-  return resultNodes;
-}
-
-function buildBingSearchUrl({ query, language, time_range }) {
-  const searchUrl = new URL("https://www.bing.com/search");
-  searchUrl.searchParams.set("q", query);
-  searchUrl.searchParams.set("pq", query);
-  searchUrl.searchParams.set("form", "QBLH");
-
-  const timeFilter = mapTimeRange(time_range, BING_TIME_RANGE);
-  if (timeFilter) {
-    searchUrl.searchParams.set("qft", timeFilter);
-  }
-
-  const languageConfig = mapLanguage(language, BING_LANGUAGE, null);
-  if (languageConfig) {
-    searchUrl.searchParams.set("setlang", languageConfig.setlang);
-    searchUrl.searchParams.set("cc", languageConfig.cc);
-    searchUrl.searchParams.set("mkt", languageConfig.mkt);
-  }
-
-  return searchUrl;
-}
-
-function buildBingRssUrl({ query, language, time_range }) {
-  const searchUrl = buildBingSearchUrl({ query, language, time_range });
-  searchUrl.searchParams.set("format", "rss");
-  return searchUrl;
-}
-
-function buildBingNewsRssUrl({ query, language }) {
-  const searchUrl = new URL("https://www.bing.com/news/search");
-  searchUrl.searchParams.set("q", query);
-  searchUrl.searchParams.set("format", "rss");
-
-  const languageConfig = mapLanguage(language, BING_LANGUAGE, null);
-  if (languageConfig) {
-    searchUrl.searchParams.set("setlang", languageConfig.setlang);
-    searchUrl.searchParams.set("cc", languageConfig.cc);
-    searchUrl.searchParams.set("mkt", languageConfig.mkt);
-  }
-
-  return searchUrl;
-}
-
-async function fetchBingHtml(searchUrl, { signal, language, runtimeContext }) {
-  const locale = mapLanguage(language, BING_LANGUAGE, BING_LANGUAGE.en);
-  return fetchSearchText(searchUrl.toString(), {
-    engine: "bing",
-    engineLabel: "Bing",
-    signal,
-    language,
-    acceptLanguage: locale
-      ? `${locale.mkt},${locale.mkt.split("-")[0]};q=0.9,en;q=0.8`
-      : getAcceptLanguageHeader(language),
-    cookies: locale
-      ? {
-          _EDGE_CD: `m=${locale.mkt}&u=${locale.mkt}`,
-          _EDGE_S: `mkt=${locale.mkt}&ui=${locale.setlang}`,
-        }
-      : undefined,
-    runtimeContext,
-    blockedStatuses: [403, 429],
-    isBlocked: isBingChallengeResponse,
-    blockedSurface: "html",
-  });
-}
-
-async function fetchBingRss(searchUrl, { signal, language, runtimeContext }) {
-  const locale = mapLanguage(language, BING_LANGUAGE, BING_LANGUAGE.en);
-  return fetchSearchText(searchUrl.toString(), {
-    engine: "bing",
-    engineLabel: "Bing",
-    signal,
-    language,
-    acceptLanguage: locale
-      ? `${locale.mkt},${locale.mkt.split("-")[0]};q=0.9,en;q=0.8`
-      : getAcceptLanguageHeader(language),
-    cookies: locale
-      ? {
-          _EDGE_CD: `m=${locale.mkt}&u=${locale.mkt}`,
-          _EDGE_S: `mkt=${locale.mkt}&ui=${locale.setlang}`,
-        }
-      : undefined,
-    headers: {
-      accept: "application/rss+xml,application/xml;q=0.9,text/xml;q=0.8,*/*;q=0.7",
-    },
-    runtimeContext,
-    blockedStatuses: [403, 429],
-    isBlocked: isBingChallengeResponse,
-    blockedSurface: "rss",
-  });
-}
-
-async function searchBing(params) {
-  const {
-    vertical = "web",
-    query,
-    language,
-    time_range,
-    pageno,
-    signal,
-    runtimeContext,
-  } = params;
-  const page = resolvePageNumber(pageno);
-
-  if (vertical === "news") {
-    const rssUrl = buildBingNewsRssUrl({
-      query,
-      language,
-    });
-    const rss = await fetchBingRss(rssUrl, { signal, language, runtimeContext });
-    return parseBingNewsRssResults(rss);
-  }
-
-  if (page > 0) {
-    throw new ApiError({
-      status: 400,
-      code: "UNSUPPORTED_PARAMETER",
-      category: "validation",
-      message: "Bing pagination is not supported",
-    });
-  }
-
-  const searchUrl = buildBingSearchUrl({
-    query,
-    language,
-    time_range,
-  });
-  const html = await fetchBingHtml(searchUrl, { signal, language, runtimeContext });
-  try {
-    return parseBingResults(html);
-  } catch (error) {
-    if (!(error instanceof ApiError) || error.code !== "UPSTREAM_PARSE_ERROR") {
-      throw error;
-    }
-
-    const rssUrl = buildBingRssUrl({
-      query,
-      language,
-      time_range,
-    });
-    const rss = await fetchBingRss(rssUrl, { signal, language, runtimeContext });
-    return parseBingRssResults(rss);
-  }
-}
-
-export const bingAdapter = {
-  name: "bing",
-  label: "Bing",
-  priority: 50,
-  tier: "primary",
-  requestPolicy: {
-    retryAttempts: 1,
-    minRequestIntervalMs: 100,
-  },
-  supports: {
-    verticals: ["web", "news"],
-    language: true,
-    time_range: true,
-    pageno: false,
-    news: {
-      time_range: false,
-      pageno: false,
-    },
-  },
-  isAvailable: () => true,
-  search: searchBing,
-};
-
-export default searchBing;

package/src/search/engines/bing.js

@@ -1,2 +0,0 @@
-export * from "./bing.impl.js";
-export { default } from "./bing.impl.js";