mytweets

mistweets

Busca todos tus tweets.

Características

• Permitir importar archivos de sus datos de archivo de Twitter
  • Significa que esta aplicación permite buscar en todo tu historial de Twitter.
• Apoya Twitter y Bluesky
• Obtenga los últimos tweets a través de la API de Twitter/API BlueSky y combínelos con su historial
  • Además, puede automatizarse mediante GitHub Actions.
• Frontend web para tus Tweets!
  • Admite búsqueda de texto completo en todos tus tweets
  • Búsqueda de texto completo basada en S3 Select
  • Puedes crear un motor de búsqueda privado para ti.

Descripción general

Uso

1. Haga clic en Usar esta plantilla y repositorio bifurcado
   • Puedes seleccionar Público o Privado
2. git clonar el repositorio bifurcado

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

Esta aplicación requiere los siguientes tokens:

• Token API de Twitter
• Claves de acceso S3
• Depósitos S3 para guardar tweets.json

Debes colocarlos en el archivo .env .

cp .env.example .env

Gorjeo

1. Crear cliente API de Twitter V2
2. Obtener clave API, secreto de clave API, token de acceso, secreto de token de acceso
3. Ponlos en el archivo .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"

T3

1. Crea un depósito S3 para guardar tus tweets.
2. Crear clave API en AWS IAM
   • Esta clave API requiere permisos GET, PUT y List para S3

Ejemplos de políticas de permisos:

YOUR_S3_BUCKET_NAME es el nombre del depósito del Paso 1

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

3. Coloque el token API y el nombre del depósito S3 en el archivo .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 " 

cielo azul

Si desea obtener publicaciones de Bluesky, puede usar yarn run fetch-bsky en lugar de yarn run fetch-tweets .

1. Agregue su cuenta bluesky a .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. Utilice yarn run fetch-bsky en lugar de yarn run fetch-tweets en [actualizar flujo de trabajo] (./.github/workflows/update.yml

Importar desde el archivo de Twitter

1. Solicita tu archivo de Twitter
2. Descargue el archivo de almacenamiento de Twitter como twitter-*.zip
3. Copiar tweeet*.js a twitter-archives/

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

4. Ejecute comandos de importación:

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

Obtenga los últimos tweets y fusione

Requerir: TWITTER_* y S3_* env en el archivo .env

Obtenga los últimos tweets de su cuenta de Twitter utilizando la API de Twitter.

El comando yarn fetch-tweets busca tweets y los fusiona en tweets.json . yarn upload-s3 sube tweets.json a tu depósito 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

Implementar sitio web

Puede implementar una interfaz web en un alojamiento web como Vercel.

1. Crear cuenta Vercel
2. Crear nuevo proyecto
3. Seleccione "Importar repositorio Git"
4. Seleccione su repositorio bifurcado
5. Establezca web/ en "Directorio raíz"
6. Establezca los siguientes valores en "Variables de entorno"
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_BUCKET_NAME
   • NEXT_PUBLIC_AUTH_KEY=<secure random string>
   • ️ Si desea limitar el acceso a su sitio web, debe establecer una cadena aleatoria segura en NEXT_PUBLIC_AUTH_KEY
   • Si desea permitir el acceso público a su sitio web, debe configurar "public" en NEXT_PUBLIC_AUTH_KEY=public
7. Desplegar
8. Puede acceder a su sitio web como https://<yourmytweets>.vercel.app/?k=<NEXT_PUBLIC_AUTH_KEY> .

Consulta de búsqueda predeterminada

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

La aplicación web admite las siguientes consultas de URL:

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

Consejos

Programar actualización

Puede automatizar yarn fetch-tweets y yarn upload-s3 usando CI como GitHub Action.

Este repositorio de plantillas incluye .github/workflows/update.yml que actualiza su tweets.json diariamente.

1. Visite la configuración de su repositorio de bifurcación https://github.com/owner/mytweets/settings/secrets/actions
2. Pon el siguiente env a los secretos de Action.
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_AWS_REGION
   • S3_BUCKET_NAME
   • Si quieres recuperar tweets
     • TWITTER_APP_KEY
     • TWITTER_APP_SECRET
     • TWITTER_ACCESS_TOKEN
     • TWITTER_ACCESS_SECRET
   • Si desea buscar publicaciones de Bluesky
     • BLUESKY_IDENTIFIER
     • BLUESKY_APPPASSWORD

Este valor es el mismo que .env .

Relacionado

• azu/delete-tweets: Twitterのアーカイブから削除候補のTweetsを抽出する補助ツールと削除するツール.

Registro de cambios

Consulte la página de lanzamientos.

Ejecución de pruebas

Instale devDependencies y ejecute npm test :

 npm test

Contribuyendo

Las solicitudes de extracción y las estrellas siempre son bienvenidas.

Para errores y solicitudes de funciones, cree un problema.

1. ¡Bifurcarlo!
2. Crea tu rama de funciones: git checkout -b my-new-feature
3. Confirme sus cambios: git commit -am 'Add some feature'
4. Empujar a la rama: git push origin my-new-feature
5. Envíe una solicitud de extracción :D

Autor

• azu: GitHub, Twitter, Bluesky

Licencia

MIT © azu