mytweets

meinetweets

Durchsuchen Sie alle Ihre Tweets.

Merkmale

• Erlauben Sie den Import eines Archivs Ihrer Twitter-Archivdaten
  • Das bedeutet, dass diese App das Durchsuchen Ihres gesamten Twitter-Verlaufs unterstützt
• Unterstützen Sie Twitter und Bluesky
• Rufen Sie die neuesten Tweets über die Twitter-API/BlueSky-API ab und führen Sie sie mit Ihrem Verlauf zusammen
  • Außerdem kann es durch GitHub-Aktionen automatisiert werden
• Web-Frontend für Ihre Tweets!
  • Unterstützen Sie die Volltextsuche für alle Ihre Tweets
  • S3-Auswahlbasierte Volltextsuche
  • Sie können eine private Suchmaschine für Sie erstellen

Überblick

Verwendung

1. Klicken Sie auf Diese Vorlage und dieses geforkte Repository verwenden
   • Sie können „Öffentlich“ oder „Privat“ auswählen
2. Git klont das geforkte Repository

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

Für diese Anwendung sind folgende Token erforderlich:

• Twitter-API-Token
• S3-Zugriffsschlüssel
• S3-Buckets zum Speichern von tweets.json

Sie müssen diese in .env Datei einfügen.

cp .env.example .env

Twitter

1. Erstellen Sie einen Twitter V2-API-Client
2. Holen Sie sich den API-Schlüssel, das API-Schlüsselgeheimnis, das Zugriffstoken und das Zugriffstokengeheimnis
3. Fügen Sie diese in .env Datei ein

 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. Erstellen Sie einen S3-Bucket zum Speichern Ihrer Tweets.
2. Erstellen Sie einen API-Schlüssel in AWS IAM
   • Für diesen API-Schlüssel sind GET-, PUT- und List-Berechtigungen für S3 erforderlich

Beispiel-Berechtigungsrichtlinien:

YOUR_S3_BUCKET_NAME ist der Bucket-Name von Schritt 1

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

3. Fügen Sie das API-Token und den S3-Bucket-Namen in .env Datei ein

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 " 

Bluesky

Wenn Sie Bluesky-Beiträge erhalten möchten, können Sie yarn run fetch-bsky anstelle von yarn run fetch-tweets verwenden.

1. Fügen Sie Ihr bluesky-Konto zu .env hinzu.

 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. Verwenden Sie yarn run fetch-bsky anstelle von yarn run fetch-tweets in [Workflow aktualisieren](./.github/workflows/update.yml

Aus Twitter-Archiv importieren

1. Fordern Sie Ihr Twitter-Archiv an
2. Laden Sie die Twitter-Archivdatei wie twitter-*.zip herunter
3. Kopieren Sie tweeet*.js nach twitter-archives/

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

4. Importbefehle ausführen:

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

Holen Sie sich die neuesten Tweets und führen Sie sie zusammen

Erforderlich: TWITTER_* und S3_* env in .env Datei

Rufen Sie mithilfe der Twitter-API die neuesten Tweets von Ihrem Twitter-Konto ab.

Der Befehl yarn fetch-tweets ruft Tweets ab und führt sie in tweets.json zusammen. yarn upload-s3 lädt die Datei tweets.json in Ihren S3-Bucket hoch.

 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

Website bereitstellen

Sie können ein Web-Frontend für Webhosting wie Vercel bereitstellen.

1. Erstellen Sie ein Vercel-Konto
2. Neues Projekt erstellen
3. Wählen Sie „Git-Repository importieren“
4. Wählen Sie Ihr geforktes Repository aus
5. Setzen Sie web/ auf „Stammverzeichnis“
6. Legen Sie die folgenden Werte auf „Umgebungsvariablen“ fest:
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_BUCKET_NAME
   • NEXT_PUBLIC_AUTH_KEY=<secure random string>
   • ️ Wenn Sie den Zugriff auf Ihre Website einschränken möchten, sollten Sie eine sichere Zufallszeichenfolge auf NEXT_PUBLIC_AUTH_KEY setzen
   • Wenn Sie den öffentlichen Zugriff auf Ihre Website zulassen möchten, sollten Sie "public" auf NEXT_PUBLIC_AUTH_KEY=public setzen
7. Einsetzen
8. Sie können auf Ihre Website zugreifen wie https://<yourmytweets>.vercel.app/?k=<NEXT_PUBLIC_AUTH_KEY> .

Standardsuchabfrage

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

Die Web-App unterstützt folgende URL-Abfragen:

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

Tipps

Planen Sie die Aktualisierung

Sie können yarn fetch-tweets und yarn upload-s3 mithilfe von CI wie GitHub Action automatisieren.

Dieses Vorlagen-Repository enthält .github/workflows/update.yml, das Ihre tweets.json täglich aktualisiert.

1. Besuchen Sie die Einstellung Ihres Fork-Repositorys https://github.com/owner/mytweets/settings/secrets/actions
2. Setzen Sie die folgende Umgebung auf die Geheimnisse von Action
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_AWS_REGION
   • S3_BUCKET_NAME
   • Wenn Sie Tweets abrufen möchten
     • TWITTER_APP_KEY
     • TWITTER_APP_SECRET
     • TWITTER_ACCESS_TOKEN
     • TWITTER_ACCESS_SECRET
   • Wenn Sie Bluesky-Beiträge abrufen möchten
     • BLUESKY_IDENTIFIER
     • BLUESKY_APPPASSWORD

Dieser Wert ist mit .env identisch.

Verwandt

• azu/delete-tweets: Twitter, Twitter, Twitter, Twitter

Änderungsprotokoll

Siehe Seite „Veröffentlichungen“.

Laufende Tests

Installieren Sie devDependencies und führen Sie npm test aus:

 npm test

Mitwirken

Pull-Requests und Stars sind jederzeit willkommen.

Bei Fehlern und Funktionswünschen erstellen Sie bitte ein Problem.

1. Gabel es!
2. Erstellen Sie Ihren Feature-Zweig: git checkout -b my-new-feature
3. Übernehmen Sie Ihre Änderungen: git commit -am 'Add some feature'
4. Zum Zweig pushen: git push origin my-new-feature
5. Senden Sie eine Pull-Anfrage :D

Autor

• azu: GitHub, Twitter, Bluesky

Lizenz

MIT © azu