Etiqueta de Mastodon no aparece en la búsqueda: pasos para solucionarlo

Creaste una etiqueta en Mastodon y esperabas que apareciera en los resultados de búsqueda, pero no muestra publicaciones o no aparece en absoluto. Esto sucede porque el motor de búsqueda de Mastodon indexa el contenido de forma diferente a las plataformas sociales tradicionales. Mastodon no indexa automáticamente cada publicación con una etiqueta; el servidor primero debe procesar y almacenar en caché los datos de la etiqueta. Este artículo explica por qué una etiqueta no aparece en la búsqueda y proporciona instrucciones paso a paso para solucionar el problema.

Por qué las etiquetas de Mastodon no aparecen en los resultados de búsqueda

Mastodon utiliza un motor de búsqueda llamado Elasticsearch para indexar publicaciones, perfiles y etiquetas. De forma predeterminada, las instancias de Mastodon no habilitan la búsqueda de texto completo. Cuando la búsqueda de texto completo está deshabilitada, la función de búsqueda solo puede coincidir con nombres de cuenta exactos o ID de publicaciones, no con el texto de la etiqueta dentro de una publicación. Incluso cuando la búsqueda de texto completo está habilitada, el proceso de indexación se ejecuta según una programación, generalmente cada pocas horas. Es posible que una etiqueta que acabas de crear no sea visible en los resultados de búsqueda hasta que se complete el siguiente ciclo de indexación.

Otra causa común es que el administrador de la instancia no haya configurado Elasticsearch correctamente. Sin una conexión funcional entre Mastodon y Elasticsearch, no se indexará ninguna etiqueta. Por último, si tu publicación proviene de un servidor federado que no está completamente sincronizado con tu instancia, la etiqueta puede existir en el servidor remoto pero no ser buscable localmente.

Pasos para solucionar una etiqueta de Mastodon faltante en la búsqueda

Sigue estos pasos en orden. Comienza con las comprobaciones más simples y pasa a las soluciones a nivel de servidor solo si es necesario.

1. Espera 24 horas para la indexación automática
   Las instancias de Mastodon normalmente reindexan el contenido cada 6 a 24 horas. Si publicaste una etiqueta hace menos de un día, espera y vuelve a comprobar después de 24 horas. Esta es la razón más común de una etiqueta faltante.
2. Busca la etiqueta exacta incluyendo el símbolo de almohadilla
   En la barra de búsqueda de Mastodon, escribe la etiqueta exactamente como la publicaste, incluyendo el símbolo #. Por ejemplo, escribe #projectupdate en lugar de solo projectupdate. Mastodon trata estas como consultas diferentes.
3. Asegúrate de que la publicación sea pública y no no listada
   Solo las publicaciones públicas se indexan para la búsqueda. Si la visibilidad de tu publicación está configurada como No listada, Solo seguidores o Directa, la etiqueta no aparecerá en los resultados de búsqueda para otros usuarios. Cambia la visibilidad de la publicación a Pública antes de publicar con una etiqueta.
4. Comprueba si la búsqueda de texto completo está habilitada en tu instancia
   Abre la interfaz web de Mastodon y haz clic en la barra de búsqueda. Si ves un mensaje como “Full-text search is not enabled on this server”, el administrador de la instancia debe habilitarla. Contacta con el administrador de tu servidor o revisa la configuración de la instancia. La búsqueda de texto completo se controla mediante la variable de entorno FULL_TEXT_SEARCH establecida en true en la configuración de Mastodon.
5. Fuerza una reindexación manual desde la terminal del servidor
   Si eres el administrador de la instancia, conéctate por SSH al servidor y ejecuta el siguiente comando: tootctl search deploy. Este comando desencadena una reindexación completa de todas las publicaciones, perfiles y etiquetas. El proceso puede tardar varios minutos según el tamaño de la base de datos. Una vez completado el comando, vuelve a comprobar los resultados de búsqueda.
6. Verifica que Elasticsearch esté en ejecución y conectado
   Ejecuta curl http://localhost:9200 desde la terminal del servidor. Si Elasticsearch está en ejecución, verás una respuesta JSON con un estado 200. Si la conexión falla, reinicia Elasticsearch con sudo systemctl restart elasticsearch y luego ejecuta tootctl search deploy de nuevo.

Si la etiqueta sigue sin aparecer después de estos pasos

La etiqueta muestra cero publicaciones aunque existan publicaciones

Esto normalmente significa que el índice está corrupto o desactualizado. Ejecuta tootctl search deploy --clean para reconstruir el índice desde cero. El indicador --clean elimina el índice antiguo antes de crear uno nuevo. Esto puede tardar más, pero resuelve la mayoría de los problemas de corrupción.

La etiqueta aparece en la búsqueda en la instancia local pero no en instancias remotas

Los retrasos de federación pueden causar esto. Es posible que las instancias remotas aún no hayan recibido la publicación. Comprueba la búsqueda de la instancia remota después de 48 horas. Si aún no aparece, la instancia remota puede haber deshabilitado la búsqueda de texto completo o puede estar bloqueando tu instancia.

La etiqueta contiene caracteres especiales o espacios

Las etiquetas de Mastodon solo pueden contener letras, números y guiones bajos. Los espacios, guiones y signos de puntuación rompen la etiqueta. Si tu etiqueta incluye un espacio, Mastodon trata solo la primera palabra como la etiqueta. Elimina cualquier carácter especial y vuelve a publicar.

Búsqueda de texto completo de Mastodon vs búsqueda básica: comportamiento de indexación

Elemento	Búsqueda de texto completo habilitada	Búsqueda básica (predeterminada)
Indexación de etiquetas	Indexada desde el texto del cuerpo de la publicación	No indexada desde el cuerpo de la publicación
Contenido buscable	Texto de la publicación, etiquetas, nombres de cuenta	Solo nombres de cuenta e ID de publicaciones
Frecuencia de actualización del índice	Cada 6–24 horas o mediante comando manual	En tiempo real solo para nombres de cuenta
Uso de recursos del servidor	Mayor uso de CPU y memoria para Elasticsearch	Mínimo
Variable de configuración	FULL_TEXT_SEARCH=true	FULL_TEXT_SEARCH=false (predeterminada)

Ahora puedes diagnosticar y solucionar una etiqueta de Mastodon faltante en los resultados de búsqueda. Comienza esperando la indexación automática y verificando la visibilidad de la publicación. Si el problema persiste, contacta con el administrador de la instancia para habilitar la búsqueda de texto completo o ejecutar el comando tootctl search deploy. Para la corrupción persistente del índice, usa el indicador --clean para reconstruir el índice desde cero. Usa siempre visibilidad pública para las etiquetas que quieras que otros descubran.