Configurer la surveillance de sources
Configurez la surveillance avec les flux Synoptic existants et leur configuration de cibles prise en charge. La création d'un flux de publication ne configure pas de scraper. La couverture, les formats de cibles, la vitesse de mise à jour, les délais et les limites de comptes varient selon le flux.
Sélectionner le moniteur et les cibles
Trouvez les flux candidats avec search, puis inspectez-les avec get_stream. Un flux social pour les publications de comptes, les requêtes de recherche, les suivis/dépublications ou les changements de profil ne couvre pas les autres. Les chaînes Telegram et l'activité des dépôts GitHub nécessitent leur flux fournisseur correspondant. Pour les actualités, les dépôts, les communiqués gouvernementaux et autres flux d'événements, utilisez les familles de sources de la compétence read-streams.
Pour un flux configurable, lisez customTargetsData.targetType, targetTypeInstruction, targetValidationRegex et les limites de nombre de cibles. Utilisez la syntaxe de cible et la casse requises par le flux. Les identifiants, les ID de comptes numériques, les URL de chaînes, les chemins de dépôts, les mots-clés, les hashtags, les cashtags et les expressions de recherche complètes ne sont pas interchangeables. Il n'existe pas d'outil de recherche d'identité ; n'inférez pas un ID numérique à partir d'un nom d'affichage. Obtenez un identifiant manquant de l'utilisateur ou d'une source vérifiée avant d'écrire. Une correspondance regex valide la syntaxe, pas l'identité ou la disponibilité de la source.
Si un flux existant couvre la demande sans cibles personnalisées, suivez-le lorsque la demande de configuration de l'utilisateur l'autorise. Si aucun flux configurable approprié n'existe, expliquez ce qui manque. Si l'utilisateur demande d'envoyer une demande de flux personnalisé, utilisez la compétence request-stream-or-feature ; une demande soumise n'est pas un moniteur actif.
Enregistrer la sélection
Vérifiez les abonnements existants avec streams_following. Si l'utilisateur a demandé de surveiller un flux éligible auquel il n'est pas abonné, appelez follow_stream avant de lire sa sélection de cibles. Lisez ensuite les cibles actuelles avec get_stream_custom_targets. Les abonnés ont leur propre sélection ; les propriétaires ont l'union de toutes les cibles des abonnés, qui ne doit pas être copiée comme sélection personnelle. Signalez les erreurs de droits ou de limites de cibles ; ne substituez pas un moniteur différent.
La modification des cibles nécessite un abonnement direct au flux avec une allocation de cibles. Un abonnement, un accès par package ou un accès par organisation ne suffit pas. Avec subscriptions.read, get_stream_subscription affiche l'abonnement direct et son allocation de cibles. Si le droit manque, expliquez ce qu'il faut configurer dans Synoptic ; ces outils ne peuvent pas l'acheter.
Utilisez patch_stream_custom_targets avec add ou remove pour une modification ciblée. set_stream_custom_targets remplace toute la sélection ; une liste vide l'efface. Préservez les cibles non concernées. Les publications pour les cibles supprimées cessent d'atteindre l'utilisateur ; les flux ouverts de l'application Synoptic appliquent la modification après reconnexion. Les cibles supprimées sont ensuite retirées des sources de collecte de l'utilisateur limitées à des cibles spécifiques ; une telle source laissée sans cibles est supprimée. get_stream_custom_targets nécessite streams.read ; set_stream_custom_targets nécessite following.write et workspace.write ; patch_stream_custom_targets nécessite également following.read.
Utilisez la compétence manage-workspace pour combiner les flux dans des tableaux de bord et appliquer des filtres par mots-clés d'inclusion/exclusion, regex ou IA. Les filtres de collecte modifient les publications qui apparaissent dans une collection, pas les cibles du scraper.
Rapporter ce qui est établi
Confirmez les cibles enregistrées à partir du résultat de l'outil, et utilisez get_stream_posts pour vérifier les mises à jour récentes le cas échéant. Rapportez l'étape atteinte : flux trouvé, accès obtenu, cibles enregistrées, collection configurée ou publications correspondantes observées. Une page d'historique vide ne prouve pas un échec, et d'anciennes publications correspondantes ne prouvent pas que les nouvelles cibles collectent. Aucun outil ne rapporte l'état de santé du scraper.
Pour la livraison dans une autre application, utilisez la compétence connect-feed-to-app. Lire les publications dans cette conversation ne démarre pas une surveillance en arrière-plan ni ne maintient un consommateur externe connecté.