Búsqueda semántica en WooCommerce con XEYE

<?php
// wp eval-file xeye-export.php > products.json
$out = array();

foreach ( wc_get_products( array( 'status' => 'publish', 'limit' => -1 ) ) as $product ) {
    $out[] = array(
        'text'        => $product->get_name(),
        'description' => wp_strip_all_tags( $product->get_short_description() ?: $product->get_description() ),
        'params'      => array(
            'id'    => $product->get_id(),
            'sku'   => $product->get_sku(),
            'price' => $product->get_price(),
            'url'   => $product->get_permalink(),
            'image' => wp_get_attachment_url( $product->get_image_id() ),
        ),
    );
}

echo wp_json_encode( $out, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES );

wp eval-file xeye-export.php > products.json

define( 'XEYE_API_KEY', 'tu-clave-api' );

<?php
/**
 * Plugin Name: XEYE Search
 * Description: Semantic product search through the XEYE API.
 */
defined( 'ABSPATH' ) || exit;

// In wp-config.php: define( 'XEYE_API_KEY', 'your-api-key' );

add_action( 'rest_api_init', function () {
    register_rest_route( 'xeye/v1', '/search', array(
        'methods'             => 'POST',
        'permission_callback' => '__return_true',
        'callback'            => function ( WP_REST_Request $request ) {
            $results = xeye_search( $request['q'], $request['limit'] );
            return is_wp_error( $results )
                ? $results
                : rest_ensure_response( array( 'results' => $results ) );
        },
        'args'                => array(
            'q'     => array(
                'required'          => true,
                'sanitize_callback' => 'sanitize_text_field',
                'validate_callback' => function ( $value ) {
                    return is_string( $value ) && strlen( trim( $value ) ) >= 2 && strlen( $value ) <= 200;
                },
            ),
            'limit' => array( 'default' => 5, 'sanitize_callback' => 'absint' ),
        ),
    ) );
} );

function xeye_search( $term, $limit = 5 ) {
    if ( ! defined( 'XEYE_API_KEY' ) ) {
        return new WP_Error( 'xeye_not_configured', 'Search is not configured.', array( 'status' => 500 ) );
    }

    // Cache each query for five minutes: repeated searches spend no credit.
    $limit     = max( 1, min( 20, (int) $limit ) );
    $cache_key = 'xeye_' . md5( strtolower( $term ) . '|' . $limit );
    $cached    = get_transient( $cache_key );
    if ( false !== $cached ) {
        return $cached;
    }

    $response = wp_remote_post( 'https://search.xeye.es/api/v1/search', array(
        'timeout' => 5,
        'headers' => array( 'Content-Type' => 'application/json', 'X-API-Key' => XEYE_API_KEY ),
        'body'    => wp_json_encode( array(
            'list_name'   => 'products',
            'search_term' => $term,
            'limit'       => $limit,
        ) ),
    ) );
    if ( is_wp_error( $response ) || 200 !== wp_remote_retrieve_response_code( $response ) ) {
        return new WP_Error( 'xeye_unavailable', 'Search is unavailable.', array( 'status' => 502 ) );
    }

    $data    = json_decode( wp_remote_retrieve_body( $response ), true );
    $results = isset( $data['results'] ) && is_array( $data['results'] ) ? $data['results'] : array();
    set_transient( $cache_key, $results, 5 * MINUTE_IN_SECONDS );
    return $results;
}

// Add to the plugin. Use it in any page with the shortcode [xeye_search].
add_shortcode( 'xeye_search', function () {
    ob_start();
    ?>
    <input type="search" id="xeye-q" placeholder="Search products" autocomplete="off">
    <ul id="xeye-results"></ul>
    <script>
      (() => {
        const ENDPOINT = <?php echo wp_json_encode( rest_url( 'xeye/v1/search' ) ); ?>;
        const input = document.getElementById('xeye-q');
        const list = document.getElementById('xeye-results');
        let timer;

        input.addEventListener('input', () => {
          clearTimeout(timer);
          const q = input.value.trim();
          if (q.length < 2) { list.replaceChildren(); return; }
          // Wait until the user stops typing: one search, not one per keystroke.
          timer = setTimeout(async () => {
            const response = await fetch(ENDPOINT, {
              method: 'POST',
              headers: { 'Content-Type': 'application/json' },
              body: JSON.stringify({ q, limit: 5 }),
            });
            const { results = [] } = await response.json();
            list.replaceChildren(...results.map((result) => {
              const item = document.createElement('li');
              const link = document.createElement('a');
              link.href = result.params?.url || '#';
              link.textContent = result.item;
              item.append(link);
              return item;
            }));
          }, 300);
        });
      })();
    </script>
    <?php
    return ob_get_clean();
} );

// Optional: make the native product search (?s=…&post_type=product) use XEYE.
add_action( 'pre_get_posts', function ( $query ) {
    if ( is_admin() || ! $query->is_main_query() || ! $query->is_search()
        || 'product' !== $query->get( 'post_type' ) ) {
        return;
    }

    $results = xeye_search( $query->get( 's' ), 20 );
    if ( is_wp_error( $results ) ) {
        return; // fall back to the native search
    }

    $ids = array_values( array_filter( array_map( function ( $result ) {
        return absint( $result['params']['id'] ?? 0 );
    }, $results ) ) );

    // An empty post__in would return every product.
    $query->set( 'post__in', $ids ? $ids : array( 0 ) );
    $query->set( 'orderby', 'post__in' ); // keep XEYE's order
    $query->set( 'xeye', true );
}, 20 ); // after WooCommerce's own pre_get_posts

// Drop WordPress's LIKE '%term%' clause, which would discard semantic matches.
add_filter( 'posts_search', function ( $search, $query ) {
    return $query->get( 'xeye' ) ? '' : $search;
}, 10, 2 );