mytweets

мои твиты

Ищите все свои твиты.

Функции

• Разрешить импорт архива данных вашего архива Твиттера
  • Это означает, что это приложение поддерживает поиск по всей вашей истории Твиттера.
• Поддержите Twitter и Bluesky
• Получайте последние твиты через Twitter API/BlueSky API и объединяйте их со своей историей.
  • Кроме того, это можно автоматизировать с помощью GitHub Actions.
• Веб-интерфейс для ваших твитов!
  • Поддержка полнотекстового поиска по всем вашим твитам.
  • S3 Полнотекстовый поиск на основе выбора
  • Вы можете создать для себя частную поисковую систему

Обзор

Использование

1. Нажмите «Использовать этот шаблон и разветвленный репозиторий».
   • Вы можете выбрать Публичный или Частный
2. git клонировать раздвоенный репозиторий

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

Для этого приложения требуются следующие токены:

• Токен API Твиттера
• S3 Ключи доступа
• Корзины S3 для сохраненияtwitter.json

Вам нужно поместить их в файл .env .

cp .env.example .env

Твиттер

1. Создать API-клиент Twitter V2
2. Получить ключ API, секрет ключа API, токен доступа, секрет токена доступа
3. Поместите их в файл .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. Создайте корзину S3 для сохранения ваших твитов.
2. Создайте ключ API в AWS IAM.
   • Для этого ключа API требуются разрешения GET, PUT, List для S3.

Пример политики разрешений:

YOUR_S3_BUCKET_NAME — это имя корзины, полученное на этапе 1.

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

3. Поместите токен API и имя корзины S3 в файл .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 " 

Блюскай

Если вы хотите получать сообщения Bluesky, вы можете использовать yarn run fetch-bsky вместо yarn run fetch-tweets .

1. Добавьте свою учетную запись 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. Используйте yarn run fetch-bsky вместо yarn run fetch-tweets в [рабочем процессе обновления](./.github/workflows/update.yml

Импорт из архива Твиттера

1. Запросите свой архив Twitter
2. Загрузите файл архива Twitter, например twitter-*.zip
3. Скопируйте tweeet*.js в twitter-archives/

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

4. Запустите команды импорта:

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

Получите последние твиты и объедините их.

Требуется: TWITTER_* и S3_* env в файле .env

Получайте последние твиты из своей учетной записи Twitter с помощью Twitter API.

Команда yarn fetch-tweets извлекает твиты и объединяет их tweets.json . yarn upload-s3 загрузите tweets.json в корзину 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

Развернуть веб-сайт

Вы можете развернуть веб-интерфейс на веб-хостинге, например Vercel.

1. Создать учетную запись Версель
2. Создать новый проект
3. Выберите «Импортировать репозиторий Git».
4. Выберите свой раздвоенный репозиторий
5. Установите для web/ значение «Корневой каталог».
6. Установите следующие значения для «Переменных среды»
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_BUCKET_NAME
   • NEXT_PUBLIC_AUTH_KEY=<secure random string>
   • ️ Если вы хотите ограничить доступ к вашему веб-сайту, вам следует установить для безопасной случайной строки значение NEXT_PUBLIC_AUTH_KEY
   • Если вы хотите разрешить публичный доступ к вашему веб-сайту, вам следует установить для параметра "public" значение NEXT_PUBLIC_AUTH_KEY=public
7. Развертывать
8. Вы можете получить доступ к своему веб-сайту, например https://<yourmytweets>.vercel.app/?k=<NEXT_PUBLIC_AUTH_KEY> .

Поисковый запрос по умолчанию

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

Веб-приложение поддерживает следующие запросы URL:

• ?k=<Your Secret Key - same with NEXT_PUBLIC_AUTH_KEY>
• &q=<search keyword>
• &max=<max search count>
  • По умолчанию: 20

Советы

Обновление расписания

Вы можете автоматизировать yarn fetch-tweets и yarn upload-s3 с помощью CI, такого как GitHub Action.

Этот репозиторий шаблонов включает в себя файл .github/workflows/update.yml, который ежедневно обновляет ваш tweets.json .

1. Посетите настройки вашего репозитория вилки https://github.com/owner/mytweets/settings/secrets/actions
2. Поместите следующее окружение в секреты действия.
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_AWS_REGION
   • S3_BUCKET_NAME
   • Если вы хотите получать твиты
     • TWITTER_APP_KEY
     • TWITTER_APP_SECRET
     • TWITTER_ACCESS_TOKEN
     • TWITTER_ACCESS_SECRET
   • Если вы хотите получать сообщения Bluesky
     • BLUESKY_IDENTIFIER
     • BLUESKY_APPPASSWORD

Эти значения такие же, как и у .env .

Связанный

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

Журнал изменений

См. страницу «Релизы».

Запуск тестов

Установите devDependency и запустите npm test :

 npm test

Содействие

Запросы на вытягивание и звезды всегда приветствуются.

Для ошибок и запросов функций, пожалуйста, создайте проблему.

1. Развилка!
2. Создайте свою ветку функций: git checkout -b my-new-feature
3. Зафиксируйте изменения: git commit -am 'Add some feature'
4. Нажмите на ветку: git push origin my-new-feature
5. Отправьте запрос на вытягивание :D

Автор

• азу: GitHub, Twitter, Bluesky

Лицензия

MIT © азу