{"id":17366961,"url":"https://github.com/gabrielrf/rss2telegram","last_synced_at":"2025-05-07T21:41:13.675Z","repository":{"id":44330920,"uuid":"511986649","full_name":"GabrielRF/Rss2Telegram","owner":"GabrielRF","description":"Automatically sends rss feed posts to Telegram","archived":false,"fork":false,"pushed_at":"2024-08-13T14:19:56.000Z","size":35,"stargazers_count":21,"open_issues_count":0,"forks_count":38,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-31T14:21:22.966Z","etag":null,"topics":["github-actions","pytelegrambotapi","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GabrielRF.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-08T18:11:04.000Z","updated_at":"2025-03-09T03:11:27.000Z","dependencies_parsed_at":"2024-11-11T17:47:26.107Z","dependency_job_id":null,"html_url":"https://github.com/GabrielRF/Rss2Telegram","commit_stats":{"total_commits":46,"total_committers":2,"mean_commits":23.0,"dds":0.3695652173913043,"last_synced_commit":"024df483cab056b8636aa76dc9366699b26058bb"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielRF%2FRss2Telegram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielRF%2FRss2Telegram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielRF%2FRss2Telegram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielRF%2FRss2Telegram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GabrielRF","download_url":"https://codeload.github.com/GabrielRF/Rss2Telegram/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252961433,"owners_count":21832184,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github-actions","pytelegrambotapi","telegram","telegram-bot"],"created_at":"2024-10-15T22:15:33.437Z","updated_at":"2025-05-07T21:41:13.626Z","avatar_url":"https://github.com/GabrielRF.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg align=\"right\" alt=\"RSS Logo\" width=\"30%\" height=\"auto\" src=\"https://rss.com/blog/wp-content/uploads/2019/10/social_style_3_rss-512-1.png\"\u003e\n\n# Rss2Telegram\n\nEnvio automático de feed RSS para pessoa, canal ou grupo no Telegram.\n\n[Mais explicações e exemplos de uso aqui](https://blog.gabrf.com/posts/Rss2Telegram/).\n\n## Participe:\n\nParticipe das conversas sobre o projeto na aba [Discussions](https://github.com/GabrielRF/Rss2Telegram/discussions).\n\nIssues também são sempre bem vindas.\n\n## Configuração:\n\nDefina as variáveis na aba `Secrets` do repositório:\n\n`BOT_TOKEN`: Token do bot que enviará as mensagens no canal ([@BotFather](https://t.me/BotFather));\n\nDefina as variáveis na aba `Variables` do repositório:\n\n`DESTINATION`: Destinos das mensagens separados por vírgulas (`@destino` ou ID). Opcionalmente, remova a variável e crie um arquivo de nome `DESTINATION.txt` com os valores;\n\n`URL`: Endereços de feeds RSS, separados por \"enter\", ou seja, um por linha. Opcionalmente, remova a variável e crie um arquivo de nome `URL.txt` com os valores;\n\n`PARAMETERS`: (opcional) Parâmetros que serão adicionados ao fim do link;\n\n`MESSAGE_TEMPLATE`: (opcional) Texto da mensagem. Valor padrão: `\u003cb\u003e{TITLE}\u003c/b\u003e` ([ver opções](#opções-de-variáveis));\n\n`BUTTON_TEXT`: (opcional) Texto do botão com o link. Sugestão: `{SITE_NAME}`. Se esta variável não for criada não será enviado um botão. ([Ver opções](#opções-de-variáveis));\n\n`EMOJIS`: (opcional) Emojis separados por vírgulas. Podem ser usados na mensagem ou no botão;\n\n`TOPIC`: (opcional) ID do tópico em que a mensagem será enviada. Necessário para grupos com a opção de tópicos ativada. [Como obter um ID de um tópico](#id-de-tópico)\n\n`TELEGRAPH_TOKEN`: (opcional) Chave para acesso ao Telegraph. [Como obter uma chave Telegraph](#chave-telegraph)\n\n`HIDE_BUTTON`: (opcional) Caso definida, desabilita o botão no envio, permitindo assim a existência do `Leitura Rápida`.\n\n### Opções de variáveis\n\n`{SITE_NAME}`: Nome do site;\n\n`{TITLE}`: Título do post;\n\n`{SUMMARY}`: Sumário do post;\n\n`{LINK}`: Link do post;\n\n`{EMOJI}`: Emoji escolhido aleatoriamente da lista.\n\n## Filtros\n\nPor padrão, todos os elementos do feed RSS serão enviados. Caso queira filtrar o conteúdo, crie um arquivo chamado `RULES.txt` e adicione as regras desejadas ao arquivo. As regras serão executadas em ordem!\n\n\u003e O valor contido em termo funcionará independente de letras maiúsculas ou minúsculas.\n\n`ACCEPT:ALL`: Todas as mensagens serão enviadas;\n\n`DROP:ALL`: Todas as mensagens não serão enviadas;\n\n`ACCEPT:termo`: A mensagem será enviada se `termo` estiver presente;\n\n`DROP:termo`: A mensagem não será enviada se `termo` estiver presente.\n\n### Exemplos de Filtros:\n\n1. Todos as mensagens serão enviadas, menos as que tiverem o termo `política`:\n\n```\nACCEPT:ALL\nDROP:Política\n```\n\n2. Nenhuma mensagem será enviada, com exceção das mensagens com os termos `futebol` e `vôlei`:\n\n```\nDROP:ALL\nACCEPT:futebol\nACCEPT:vôlei\n```\n\n## Uso\n\nFaça um *Fork*, defina as variáveis e habilite a ação em \"*Enable workflow*\". Pronto! \n\n![Enable Workflow](https://user-images.githubusercontent.com/7331540/178158090-bf774cae-071b-4ac2-ab03-9c5c1132b79e.png)\n\nA ação irá buscar as atualizações a cada hora conforme definido no arquivo [cron.yml](.github/workflows/cron.yml).\n\n## ID de tópico\n\nCaso o grupo tenha a opção de tópicos ativada, será necessário indicar em qual tópico a mensagem será enviada. Isto é feito usando-se a variável `TOPIC`. A maneira mais fácil de se obter um ID de um tópico é copiando o link de uma mensagem de um tópico. O ID será o penúltimo número do link.\n\nExemplo: O link para uma mensagem de um tópico seria `https://t.me/c/987654321/123/4567`. Neste caso, `123` seria o ID do tópico, o número que deveria ser colocado na variável.\n\n## Chave Telegraph\n\n\u003e Atenção: Caso a variável \u003ci\u003eTELEGRAPH_TOKEN\u003c/i\u003e esteja definida, o post não terá botão ou imagem, pois ambos não permitiriam a existência da opção \"Visualização Rápida\".\n\nPara criar sua chave de acesso ao Telegraph e gerar a \u003ci\u003eVisualização Rápida\u003c/i\u003e de qualquer site, acesse:\n\n```\nhttps://api.telegra.ph/createAccount?short_name=\u003cSHORT_NAME\u003e\u0026author_name=\u003cAUTHOR_NAME\u003e\n```\n\n* `SHORT_NAME`: Uma abreviação de seu nome;\n\n* `AUTHOR_NAME`: Seu nome.\n\nA resposta do site será algo como:\n\n```\n{\n  \"ok\": true,\n  \"result\": {\n    \"short_name\": \"NOME\",\n    \"author_name\": \"NOME\",\n    \"author_url\": \"\",\n    \"access_token\": \"abcdefghijklmnopqrtuvxz123456789\",\n    \"auth_url\": \"https://edit.telegra.ph/auth/123456789012345678901234567890\"\n  }\n}\n```\n\nO valor presente em `access_token` é o valor a ser usado na variável `TELEGRAPH_TOKEN`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielrf%2Frss2telegram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgabrielrf%2Frss2telegram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielrf%2Frss2telegram/lists"}