mytweets

mes tweets

Recherchez tous vos tweets.

Caractéristiques

• Autoriser l'importation d'archives de vos données d'archives Twitter
  • Cela signifie que cette application prend en charge la recherche dans tout votre historique Twitter.
• Soutenez Twitter et Bluesky
• Récupérez les derniers tweets via l'API Twitter/API BlueSky et fusionnez-les avec votre historique
  • En outre, il peut être automatisé par GitHub Actions
• Frontend Web pour vos Tweets !
  • Prise en charge de la recherche en texte intégral sur tous vos tweets
  • Recherche de texte intégral basée sur S3 Select
  • Vous pouvez créer un moteur de recherche privé pour vous

Aperçu

Usage

1. Cliquez sur Utiliser ce modèle et ce référentiel forké
   • Vous pouvez sélectionner Public ou Privé
2. git clone le dépôt forké

git clone https://github.com/you/mytweets
cd mytweets

Cette application nécessite les jetons suivants :

• Jeton API Twitter
• Clés d'accès S3
• Compartiments S3 pour enregistrer tweets.json

Vous devez les mettre dans le fichier .env .

cp .env.example .env

Gazouillement

1. Créer un client API Twitter V2
2. Obtenez la clé API, la clé secrète API, le jeton d'accès, le secret du jeton d'accès
3. Mettez-les dans le fichier .env

 S3_AWS_ACCESS_KEY_ID="x"
S3_AWS_SECRET_ACCESS_KEY="x"
S3_AWS_REGION="us-east-1"
S3_BUCKET_NAME="x"
TWITTER_APP_KEY="YOUR_TWITTER_API_KEY"
TWITTER_APP_SECRET="YOUR_TWITTER_API_KEY_SECRET"
TWITTER_ACCESS_TOKEN="YOUR_TWITTER_ACCESS_TOKEN"
TWITTER_ACCESS_SECRET="YOUR_TWITTER_ACCESS_TOKEN_SECRET"

S3

1. Créez un compartiment S3 pour enregistrer vos tweets.
2. Créer une clé API sur AWS IAM
   • Cette clé API nécessite les autorisations GET, PUT, List pour S3

Exemples de politiques d'autorisation :

YOUR_S3_BUCKET_NAME est le nom du bucket de l'étape 1

{
  "Version" : " 2012-10-17 " ,
  "Statement" : [
    {
      "Sid" : " mytweets " ,
      "Effect" : " Allow " ,
      "Action" : " s3:* " ,
      "Resource" : " arn:aws:s3:::{your-mytweets-bucket-name}/* "
    }
  ]
}

3. Mettez le jeton API et le nom du compartiment S3 dans le fichier .env

S3_AWS_ACCESS_KEY_ID= " x "
S3_AWS_SECRET_ACCESS_KEY= " x "
S3_AWS_REGION= " us-east-1 "
S3_BUCKET_NAME= " x "
TWITTER_APP_KEY= " YOUR_TWITTER_API_KEY "
TWITTER_APP_SECRET= " YOUR_TWITTER_API_KEY_SECRET "
TWITTER_ACCESS_TOKEN= " YOUR_TWITTER_ACCESS_TOKEN "
TWITTER_ACCESS_SECRET= " YOUR_TWITTER_ACCESS_TOKEN_SECRET " 

Ciel bleu

Si vous souhaitez obtenir des publications Bluesky, vous pouvez utiliser yarn run fetch-bsky au lieu de yarn run fetch-tweets .

1. Ajoutez votre compte bluesky à .env .

 S3_AWS_ACCESS_KEY_ID = "x"
S3_AWS_SECRET_ACCESS_KEY = "x"
S3_AWS_REGION = "us-east-1"
S3_BUCKET_NAME = "x"
BLUESKY_IDENTIFIER = "xxx.bsky.social"
BLUESKY_APPPASSWORD = "x"

2. Utilisez yarn run fetch-bsky au lieu de yarn run fetch-tweets dans [update workflow](./.github/workflows/update.yml

Importer depuis les archives Twitter

1. Demandez vos archives Twitter
2. Téléchargez le fichier d'archive Twitter comme twitter-*.zip
3. Copiez tweeet*.js dans twitter-archives/

 twitter-archives/
├── tweet.js
├── tweet-part1.js
└── tweet-part2.js

4. Exécutez les commandes d'importation :

 yarn install
yarn import-twitter-archives # Concvert twitter-archives
yarn fetch-tweets  # Fetch diffs via Twitter API
yarn upload-s3 # upload to S3

Récupérez les derniers tweets et fusionnez

Exiger : TWITTER_* et S3_* env dans le fichier .env

Récupérez les derniers tweets de votre compte Twitter à l'aide de l'API Twitter.

La commande yarn fetch-tweets récupère les tweets et les fusionne dans tweets.json . yarn upload-s3 Téléchargez le tweets.json dans votre compartiment S3.

 yarn install
yarn download-s3 # download tweets.json from S3
yarn fetch-tweets  # Fetch diffs via Twitter API
yarn prefetch-bsky  # Fetch diffs via Bluesky API
yarn upload-s3 # upload to S3

Déployer le site Web

Vous pouvez déployer une interface Web sur un hébergement Web comme Vercel.

1. Créer un compte Vercel
2. Créer un nouveau projet
3. Sélectionnez "Importer le référentiel Git"
4. Sélectionnez votre référentiel forké
5. Définissez web/ sur "Répertoire racine"
6. Définissez les valeurs suivantes sur "Variables d'environnement"
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_BUCKET_NAME
   • NEXT_PUBLIC_AUTH_KEY=<secure random string>
   • ️ Si vous souhaitez limiter l'accès à votre site Web, vous devez définir une chaîne aléatoire sécurisée sur NEXT_PUBLIC_AUTH_KEY
   • Si vous souhaitez autoriser l'accès public à votre site Web, vous devez définir "public" sur NEXT_PUBLIC_AUTH_KEY=public
7. Déployer
8. Vous pouvez accéder à votre site Web comme https://<yourmytweets>.vercel.app/?k=<NEXT_PUBLIC_AUTH_KEY> .

Requête de recherche par défaut

https://<yourmytweets>.vercel.app/?k=<NEXT_PUBLIC_AUTH_KEY>&q=<search keyword>&max=<max search count>

L'application Web prend en charge les requêtes d'URL suivantes :

• ?k=<Your Secret Key - same with NEXT_PUBLIC_AUTH_KEY>
• &q=<search keyword>
• &max=<max search count>
  • Par défaut : 20

Conseils

Planifier la mise à jour

Vous pouvez automatiser yarn fetch-tweets et yarn upload-s3 à l'aide de CI comme GitHub Action.

Ce référentiel de modèles comprend .github/workflows/update.yml qui met à jour quotidiennement votre tweets.json .

1. Visitez les paramètres de votre référentiel fork https://github.com/owner/mytweets/settings/secrets/actions
2. Mettez l'environnement suivant dans les secrets d'Action
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_AWS_REGION
   • S3_BUCKET_NAME
   • Si vous souhaitez récupérer des tweets
     • TWITTER_APP_KEY
     • TWITTER_APP_SECRET
     • TWITTER_ACCESS_TOKEN
     • TWITTER_ACCESS_SECRET
   • Si vous souhaitez récupérer les messages Bluesky
     • BLUESKY_IDENTIFIER
     • BLUESKY_APPPASSWORD

Cette valeur est la même que celle de .env .

En rapport

• azu/delete-tweets : Twitter a publié des tweets.

Journal des modifications

Voir la page des versions.

Exécution de tests

Installez devDependencies et exécutez npm test :

 npm test

Contribuer

Les demandes de tirage et les étoiles sont toujours les bienvenues.

Pour les bogues et les demandes de fonctionnalités, veuillez créer un problème.

1. Fourchette-le !
2. Créez votre branche de fonctionnalités : git checkout -b my-new-feature
3. Validez vos modifications : git commit -am 'Add some feature'
4. Push vers la branche : git push origin my-new-feature
5. Soumettre une pull request :D

Auteur

• azu : GitHub, Twitter, Bluesky

Licence

MIT © azu