mytweets

meus tweets

Pesquise todos os seus tweets.

Características

• Permitir a importação do arquivo dos dados do seu arquivo do Twitter
  • Isso significa que este aplicativo oferece suporte para pesquisar todo o seu histórico do Twitter
• Apoie Twitter e Bluesky
• Obtenha os tweets mais recentes via Twitter API/BlueSky API e mescle-os com seu histórico
  • Além disso, pode ser automatizado por GitHub Actions
• Web Frontend para seus Tweets!
  • Suporte para pesquisa de texto completo em todos os seus tweets
  • Pesquisa de texto completo baseada em S3 Select
  • Você pode criar um mecanismo de pesquisa privado para você

Visão geral

Uso

1. Clique em Usar este modelo e repositório bifurcado
   • Você pode selecionar Público ou Privado
2. git clonar o repositório bifurcado

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

Este aplicativo requer os seguintes tokens:

• Token da API do Twitter
• Chaves de acesso S3
• Baldes S3 para salvar tweets.json

Você precisa colocá-los no arquivo .env .

cp .env.example .env

Twitter

1. Criar cliente API do Twitter V2
2. Obtenha chave de API, segredo de chave de API, token de acesso, segredo de token de acesso
3. Coloque-os no arquivo .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. Crie um bucket S3 para salvar seus tweets.
2. Crie uma chave API no AWS IAM
   • Esta chave de API requer permissões GET, PUT, List para S3

Exemplo de políticas de permissão:

YOUR_S3_BUCKET_NAME é o nome do intervalo da Etapa 1

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

3. Coloque o token da API e o nome do bucket S3 no arquivo .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 " 

Céu Azul

Se você deseja obter postagens do Bluesky, você pode usar yarn run fetch-bsky em vez de yarn run fetch-tweets .

1. Adicione sua conta 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. Use yarn run fetch-bsky em vez de yarn run fetch-tweets em [fluxo de trabalho de atualização](./.github/workflows/update.yml

Importar do arquivo do Twitter

1. Solicite seu arquivo do Twitter
2. Baixe o arquivo do Twitter como twitter-*.zip
3. Copie tweeet*.js para twitter-archives/

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

4. Execute comandos de importação:

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

Obtenha os tweets mais recentes e mescle

Exigir: TWITTER_* e S3_* env no arquivo .env

Obtenha os tweets mais recentes da sua conta do Twitter usando a API do Twitter.

O comando yarn fetch-tweets busca tweets e mescla-os em tweets.json . yarn upload-s3 carrega o tweets.json para o seu bucket 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

Implantar site

Você pode implantar front-end da web em hospedagem na web como Vercel.

1. Criar conta Vercel
2. Criar novo projeto
3. Selecione "Importar repositório Git"
4. Selecione seu repositório bifurcado
5. Defina web/ como "Diretório raiz"
6. Defina os seguintes valores para "Variáveis ​​de Ambiente"
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_BUCKET_NAME
   • NEXT_PUBLIC_AUTH_KEY=<secure random string>
   • ️ Se quiser limitar o acesso ao seu site, você deve definir uma string aleatória segura como NEXT_PUBLIC_AUTH_KEY
   • Se quiser permitir o acesso público ao seu site, você deve definir "public" como NEXT_PUBLIC_AUTH_KEY=public
7. Implantar
8. Você pode acessar seu site como https://<yourmytweets>.vercel.app/?k=<NEXT_PUBLIC_AUTH_KEY> .

Consulta de pesquisa padrão

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

O aplicativo da web oferece suporte às seguintes consultas de URL:

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

Pontas

Agendar atualização

Você pode automatizar yarn fetch-tweets e yarn upload-s3 usando CI como o GitHub Action.

Este repositório de modelos inclui .github/workflows/update.yml que atualiza seu tweets.json diariamente.

1. Visite a configuração do seu repositório fork https://github.com/owner/mytweets/settings/secrets/actions
2. Coloque o seguinte ambiente nos segredos da Action
   • S3_AWS_ACCESS_KEY_ID
   • S3_AWS_SECRET_ACCESS_KEY
   • S3_AWS_REGION
   • S3_BUCKET_NAME
   • Se você quiser buscar tweets
     • TWITTER_APP_KEY
     • TWITTER_APP_SECRET
     • TWITTER_ACCESS_TOKEN
     • TWITTER_ACCESS_SECRET
   • Se você deseja buscar postagens do Bluesky
     • BLUESKY_IDENTIFIER
     • BLUESKY_APPPASSWORD

Esse valor é igual a .env .

Relacionado

• azu/delete-tweets: Twitter.

Registro de alterações

Consulte a página de lançamentos.

Executando testes

Instale devDependencies e execute npm test :

 npm test

Contribuindo

Solicitações pull e estrelas são sempre bem-vindas.

Para bugs e solicitações de recursos, crie um problema.

1. Garfo!
2. Crie seu branch de recursos: git checkout -b my-new-feature
3. Confirme suas alterações: git commit -am 'Add some feature'
4. Empurre para o branch: git push origin my-new-feature
5. Envie uma solicitação pull :D

Autor

• azu: GitHub, Twitter, Bluesky

Licença

MIT © azu